دليل المبتدئين إلى لغة Kusto Query Language لـ Azure Resource Graph

By Mirko Peters · 2026-10-21

أتقن لغة Kusto Query Language (KQL) لـ Azure Resource Graph. تعلّم بناء الجمل البسيطة، وفلاتر خطوط الأنابيب، والاستعلامات لإدارة بيئتك السحابية.

Automatically translated with AI from the original post. Read the English original

إن إتقان لغة Kusto Query Language (KQL) لـ Azure Resource Graph يُمكّن مديري السحابة من كتابة استعلامات نظيفة وسريعة للغاية، تعرض بسهولة جرد السحابة والمخاطر الأمنية والامتثال للحوكمة عبر عدة اشتراكات، دون الاعتماد على النقر اليدوي في البوابة.

النقاط الرئيسية

• تُقرأ استعلامات KQL كوصفة، إذ تُستخدم رمز الفاصل العمودي (|) لربط خطوات معالجة البيانات المتتابعة.
• يحتوي الجدول الافتراضي 'resources' على معظم ما تحتاج إليه للاستعلام عبر عدة اشتراكات Azure في آنٍ واحد.
• يساعدك استخدام العاملين project وextend على تنظيف المخرجات غير المرتبة واستخراج قيم الخصائص المتداخلة دون تعقيد زائد في الكود.
• يقصر Resource Graph النتائج افتراضياً على 1,000 سجل كإجراء وقائي، ما يستلزم استخدام رموز الترقيم للبيئات الضخمة.
• تنتقل مهارات KQL المكتسبة في Azure Resource Graph مباشرةً إلى Log Analytics وAzure Data Explorer.

تبسيط KQL في Azure Resource Graph

عند مواجهة Kusto Query Language (KQL) للمرة الأولى، قد يبدو الاختصار مُخيفاً. غير أنّ تجريد المصطلحات التقنية يكشف عن بناء جملة سهل وشبيه بالإنجليزية، صُمّم ليجعل استعلام البنية التحتية السحابية بديهياً. فعلى عكس كتابة التطبيقات المعقدة أو السكربتات الثقيلة، تركز KQL على طرح الأسئلة واسترجاع البيانات المنظمة فقط.

كل سؤال تطرحه داخل Azure Resource Graph مبني على KQL. وإن سبق لك استخدام Azure Data Explorer أو Log Analytics، فسيبدو لك هذا البناء مألوفاً فوراً. أما إن كنت تبدأ من الصفر، فمنحنى التعلم منخفض بشكل مدهش. يمكنك تعلّم الجزء الأساسي من KQL اللازم للإدارة السحابية اليومية في جلسة واحدة.

تشريح استعلام KQL

يُقرأ استعلام KQL كوصفة خطوة بخطوة. وسرّ هذه القابلية للقراءة هو رمز الفاصل العمودي (|) الذي يفصل بين التعليمات المنفصلة. تبدأ بجدول بيانات أساسي، ثم تمرره عبر أوامر متتالية تضيّق المخرجات أو تصفّيها أو تعيد تشكيلها.

اقرأ استعلام KQL من الأعلى إلى الأسفل، وستبدو قراءته أشبه بالإنجليزية العادية. على سبيل المثال، لنأخذ أبسط استعلام مفيد يمكنك كتابته:

resources | summarize count

إذا نطقنا هذا الأمر بصوت عالٍ، فهو يعني: خذ كل ما في الجدول الافتراضي resources، وأعطني عدداً. يعيد النظام رقماً واحداً ذا قيمة عالية يمثل الحجم الإجمالي لبيئتك السحابية.

العوامل الأساسية لمديري السحابة

بعد أن تتقن عدّ أصولك، ستحتاج إلى تصفية البيانات وتنسيقها. تقوم بعض العوامل الأساسية بالعمل الشاق في تقريباً كل استعلام إداري:

• where: يُصفّي مجموعة البيانات وفقاً لشروط محددة. على سبيل المثال، إذا غيّرت استعلامك إلى resources | where type == "Microsoft.Compute/virtualMachines"، فسيقتصر العدّ على الأجهزة الافتراضية فقط.
• project: يحدد الأعمدة المحددة التي تظهر في المخرجات النهائية، ما يتيح لك عرض اسم المورد والموقع ومعرّف الاشتراك فقط، بدلاً من عرض كمّ هائل من بيانات JSON الخام.
• order by: يرتب نتائجك أبجدياً أو عددياً، فيحوّل تفريغ البيانات العشوائي إلى جدول منظم وسهل المسح البصري.
• extend: ينشئ عموداً مخصصاً مؤقتاً، ويتيح لك استخراج قيم إعدادات متداخلة بعمق ومنحها تسميات قصيرة قابلة لإعادة الاستخدام.

تجنّب الأخطاء الشائعة في KQL

على الرغم من أن KQL متساهلة في بعض الجوانب، إلا أن لديها قواعد صارمة فيما يتعلق بحالة الأحرف. يتجاهل عامل المطابقة غير الحساس لحالة الأحرف (ويُكتب كعلامة يساوي متبوعة بعلامة التيلدا، مثل =~) حالة الأحرف بسهولة عند البحث عن قيم نصية مثل أنواع الموارد. أما أسماء الخصائص فالأمر مختلف تماماً. فإذا أخطأتَ في كتابة اسم خاصية أو غيّرت حالة أحرفه، فلن تُظهر KQL خطأ صريحاً في بناء الجملة، بل ستُعيد قيماً فارغة بصمت، مما يتركك تبحث عن خلل غير موجود في منطقك.

الاستفادة من الجداول أبعد من الأساسيات

على الرغم من أن الجدول resources يغطي الغالبية العظمى من عمليات التحقق الإدارية اليومية، توجد جداول متخصصة لأعمال الحوكمة الأعمق. عندما تحتاج إلى تدقيق وضعيات الأمان، أو مراجعة تعيينات السياسات، أو فحص الحاويات التنظيمية مثل مجموعات الإدارة والاشتراكات ومجموعات الموارد، يمكنك توجيه استعلامات KQL مباشرةً إلى هذه الجداول المخصصة.

وبما أن KQL معيار مشترك عبر خدمات منظومة Microsoft، فإن إتقان هذه الأنماط يمنحك مضاعِفاً مهنياً فورياً. فالاستعلامات التي تكتبها اليوم لتنظيف مجموعات أمان الشبكات اليتيمة أو لتحديد أجهزة Virtual Machines غير الموسومة ستخدمك بالقدر نفسه عند كتابة تنبيهات الأمان في Microsoft Defender أو بناء لوحات المعلومات التشغيلية في Log Analytics.

الخلاصة والخطوات التالية

يحوّل تعلّم لغة الاستعلام Kusto محرك Azure Resource Graph من آلية خلفية غامضة إلى أداة يومية مفضلة لإدارة السحابة. فبالاستعاضة عن النقر المرهق في البوابة والنصوص البرمجية الهشة باستعلامات موجزة وسهلة القراءة، تكتسب رؤية كاملة على بيئتك المتعددة الاشتراكات.

لمزيد من التعمق في تبسيط سير عمل إدارة السحابة، استمع إلى الحلقة الكاملة للحصول على رؤى خبراء إضافية وأمثلة عملية وإرشادات تطبيقية حول كيفية الاستفادة من Azure Resource Graph في مؤسستك.

الأسئلة المتداولة

ما هي KQL ولماذا تُستخدم في Azure Resource Graph؟

تعني KQL لغة الاستعلام Kusto. وهي لغة استعلام خفيفة وبديهية تُستخدم لطرح الأسئلة على بيئة Azure الخاصة بك في Resource Graph. تتيح لك تصفية الآلاف من موارد السحابة وفرزها وتجميعها فورياً باستخدام بناء جملة مقروء يعتمد على الفاصل العمودي (pipe).

كيف أُصفّي الموارد حسب النوع باستخدام KQL؟

يمكنك تصفية الموارد بإضافة عبارة 'where' بعد تعريف الجدول الأولي. على سبيل المثال، كتابة 'resources | where type =~ "microsoft.keyvault/vaults"' ستُعيد لك Azure Key Vaults فقط.

لماذا يُعيد استعلام KQL الخاص بي قيماً فارغة بدلاً من خطأ؟

أسماء الخصائص في KQL حساسة لحالة الأحرف. فإذا أخطأتَ في حالة أحرف اسم الخاصية، فلن يُظهر Azure Resource Graph خطأ في بناء الجملة، بل سيُعيد قيماً فارغة بصمت، مما يجعل تصحيح الأخطاء صعباً.

ما هو حد الـ 1,000 سجل في Azure Resource Graph؟

افتراضياً، يُعيد استعلام resource graph ما يصل إلى 1,000 سجل كحد أقصى، وذلك لحماية المستخدمين من سحب مجموعات بيانات ضخمة دون قصد. يمكنك تجاوز هذا الحد أو التنقل بين صفحاته باستخدام continuation tokens إذا كانت بيئتك تحتوي على آلاف الموارد.