تصحيح استعلامات Azure Stream Analytics محليا باستخدام الرسم التخطيطي للمهمة في التعليمات البرمجية Visual Studio (معاينة)

  • مقالة
  • قراءة خلال 3 دقائق

غالبا ما تحتاج مهام البث التي لا تنتج أي نتيجة أو نتائج غير متوقعة إلى استكشاف الأخطاء وإصلاحها. يدمج ملحق التعليمات البرمجية Visual Studio ل Azure Stream Analytics الرسومات التخطيطية للمهام والمقاييس وسجلات التشخيص والنتائج الوسيطة لمساعدتك على عزل مصدر المشكلة بسرعة. يمكنك استخدام الرسم التخطيطي للمهمة أثناء اختبار الاستعلام محليا لفحص مجموعة النتائج الوسيطة والمقاييس لكل خطوة.

تصحيح استعلام باستخدام الرسم التخطيطي للمهمة

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

ملاحظة

يعرض الرسم التخطيطي للوظيفة هذا البيانات والمقاييس الخاصة بالاختبار المحلي في عقدة واحدة فقط. لا ينبغي استخدامه لضبط الأداء واستكشاف الأخطاء وإصلاحها.

بدء الاختبار المحلي

استخدم هذه البداية السريعة للتعرف على كيفية إنشاء مهمة Stream Analytics باستخدام Visual Studio Code أو تصدير مهمة حالية إلى مشروع محلي. تتم تعبئة بيانات اعتماد المدخلات والمخرجات تلقائيا للوظائف المصدرة.

إذا كنت تريد اختبار الاستعلام باستخدام بيانات الإدخال المحلية، فاتبع هذه الإرشادات. إذا كنت تريد الاختبار باستخدام الإدخال المباشر، فقم بتكوين نقل الإدخال إلى الخطوة التالية.

افتح ملف البرنامج النصي . asaql وحدد تشغيل محليا. ثم حدد استخدام الإدخال المحلي أو استخدام الإدخال المباشر. يظهر الرسم التخطيطي للمهمة على الجانب الأيسر من النافذة.

عرض مجموعة المخرجات والنتائج الوسيطة

  1. يتم عرض كافة مخرجات المهمة في نافذة النتائج في الجانب السفلي الأيسر من نافذة Visual Studio Code.

    Job output results

  2. حدد خطوة الاستعلام للانتقال إلى البرنامج النصي. يتم توجيهك تلقائيا إلى البرنامج النصي المقابل في المحرر على اليمين. تظهر النتيجة الوسيطة في نافذة النتائج في الجانب السفلي الأيسر من نافذة Visual Studio Code.

    Job diagram preview result

عرض القياسات

في هذا القسم، يمكنك استكشاف المقاييس المتاحة لكل جزء من الرسم التخطيطي.

  1. حدد علامة التبويب المقاييس بجوار علامة التبويب النتائج في الجانب السفلي الأيسر من نافذة رمز Visual Studio.

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

    Job diagram metrics

  3. حدد اسم مصدر بيانات الإدخال من القائمة المنسدلة للاطلاع على مقاييس الإدخال. يسمى مصدر الإدخال في لقطة الشاشة أدناه علامات الاقتباس. لمزيد من المعلومات حول مقاييس الإدخال، راجع فهم مراقبة مهام Stream Analytics وكيفية مراقبة طلبات البحث.

    Job diagram input metrics

  4. حدد خطوة استعلام من الرسم التخطيطي للمهمة أو حدد اسم الخطوة من القائمة المنسدلة للاطلاع على مقاييس مستوى الخطوة. تأخير العلامة المائية هو مقياس الخطوة الوحيد المتاح.

    Step metrics

  5. حدد مخرجات في الرسم التخطيطي أو من القائمة المنسدلة للاطلاع على المقاييس المتعلقة بالمخرجات. لمزيد من المعلومات حول مقاييس المخرجات، راجع فهم مراقبة مهام Stream Analytics وكيفية مراقبة طلبات البحث. أحواض الإخراج المباشر غير مدعومة.

    Output metrics

اعرض البيانات التشخيصية

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

Diagnostic logs

حدد إدخال سجل لرؤية الرسالة بأكملها.

Diagnostic logs message

ميزات الرسم التخطيطي للوظيفة الأخرى

يمكنك تحديد إيقاف أو إيقاف مؤقت من شريط الأدوات حسب الحاجة. بمجرد إيقاف المهمة مؤقتا ، يمكنك استئنافها من آخر إخراج.

Stop or pause job

حدد ملخص المهمة في أعلى يسار الرسم التخطيطي للمهمة لعرض الخصائص والتكوينات الخاصة بوظيفتك المحلية.

Local job summary

التقييدات

  • أحواض الإخراج المباشر غير مدعومة في التشغيل المحلي.

  • تشغيل المهمة محليا مع وظيفة جافا سكريبت مدعوم فقط على نظام التشغيل Windows.

  • لا يتم دعم التعليمات البرمجية المخصصة C# ووظائف Azure التعلم الآلي.

  • فقط خيارات الإدخال السحابية لديها دعم سياسات الوقت ، في حين أن خيارات الإدخال المحلية لا تفعل ذلك.

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