مشاركة عبر

اختبار وظيفة Azure Stream Analytics في المدخل

  • مقالة

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

عينة البيانات الواردة تلقائيًا من الإدخال

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

  1. سجّل الدخول إلى مدخل Azure.

  2. حدد موقع وظيفة Stream Analytics الحالية وحددها.

  3. في صفحة وظيفة Stream Analytics، ضمن عنوان مخطط الوظيفة، حدد الاستعلام لفتح نافذة محرر الاستعلام.

  4. لمشاهدة قائمة نموذجية بالأحداث الواردة، حدد الإدخال مع أيقونة الملف وستظهر أحداث العينة تلقائيا في معاينة الإدخال.

    أ. يتم اكتشاف نوع التسلسل لبياناتك تلقائيًا إذا كان JSON أو CSV. يمكنك تغييره يدويًا أيضًا إلى JSON وCSV وAVRO عن طريق تغيير الخيار في القائمة المنسدلة.

    ب. استخدم المحدد لعرض البيانات بتنسيق Table أو Raw.

    ج. إذا لم تكن بياناتك المعروضة حديثة، فحدد تحديث لمشاهدة آخر الأحداث.

    الجدول التالي عبارة عن مثال على البيانات الموجودة في تنسيق الجدول:

    عينة إدخال Azure Stream Analytics في تنسيق الجدول

    الجدول التالي عبارة عن مثال على البيانات الموجودة في التنسيق الأولي:

    عينة إدخال Azure Stream Analytics في التنسيق الأولي

  5. لاختبار استعلامك مع البيانات الواردة، حدد اختبار الاستعلام. تظهر النتائج في علامة التبويب نتائج الاختبار. كما يمكنك تحديد تنزيل النتائج لتنزيل النتائج.

    نتائج استعلام اختبار عينة Azure Stream Analytics

  6. لاختبار استعلامك مقابل نطاق زمني محدد للأحداث الواردة، حدد تحديد النطاق الزمني.

    النطاق الزمني لـ Azure Stream Analytics لأحداث العينة الواردة

  7. عيِّن النطاق الزمني للأحداث التي تريد استخدامها لاختبار الاستعلام وتحديد نموذج. ضمن هذا الإطار الزمني، يمكنك استرداد ما يصل إلى 1000 حدث أو 1 ميغابايت، أيهما يأتي أولاً.

    النطاق الزمني المحدد لـ Azure Stream Analytics لأحداث العينة الواردة

  8. بمجرد أخذ عينات من الأحداث للنطاق الزمني المحدد، تظهر في علامة التبويب معاينة الإدخال.

    نتائج اختبار عرض Azure Stream Analytics

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

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

  11. بعد التحقق من النتائج المعروضة في المستعرض، تصبح جاهزًا لـ بدء المهمة.

تحميل بيانات نموذجية من ملف محلي

بدلا من استخدام البيانات المباشرة، يمكنك استخدام بيانات نموذجية من ملف محلي لاختبار استعلام Azure Stream Analytics.

  1. سجّل الدخول إلى مدخل Azure.

  2. حدد موقع وظيفة Stream Analytics الحالية وحددها.

  3. في صفحة وظيفة Stream Analytics، ضمن عنوان مخطط الوظيفة، حدد الاستعلام لفتح نافذة محرر الاستعلام.

  4. لاختبار استعلامك باستخدام ملف محلي، حدد تحميل إدخال عينة في علامة التبويب معاينة الإدخال.

    لقطة شاشة تظهر خيار تحميل إدخال عينة.

  5. حمل الملف المحلي لاختبار الاستعلام. لا يمكنك سوى تحميل الملفات بتنسيقات JSON أو CSV أو AVRO. حدد "OK".

    تُظهر لقطة الشاشة مربع الحوار تحميل بيانات العينة، حيث يمكنك تحديد ملف.

  6. بمجرد تحميل الملف، يمكنك أيضًا رؤية محتويات الملف في النموذج كجدول أو بتنسيق أولي. إذا حددت إعادة تعيين، فستعود عينة البيانات إلى بيانات الإدخال الواردة الموضحة في القسم السابق. يمكنك تحميل أي ملف آخر لاختبار الاستعلام في أي وقت.

  7. حدد استعلام الاختبار لاختبار استعلامك مقابل ملف العينة الذي تم تحميله.

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

  9. عند استخدام مخرجات متعددة في الاستعلام، يتم عرض النتائج استنادًا إلى الإخراج المحدد.

    إخراج محدد لـ Azure Stream Analytics

  10. بعد التحقق من النتائج المعروضة في المستعرض، يمكنك بدء المهمة.

التقييدات

  1. نهج الوقت غير مدعوم في اختبار المدخل:

    • خارج الترتيب: سيتم ترتيب جميع الأحداث الواردة.
    • الوصول المتأخر: لن يكون هناك حدث وصول متأخر لأن Stream Analytics لا يمكنه سوى استخدام البيانات الموجودة للاختبار.

  2. C# UDF غير مدعوم.

  3. سيتم تشغيل جميع الاختبارات مع وظيفة تحتوي على وحدة دفق واحدة.

  4. حجم المهلة دقيقة واحدة. لذلك، لا يمكن لأي استعلام بحجم نافذة أكبر من دقيقة واحدة الحصول على أي بيانات.

  5. التعلم الآلي غير مدعوم.

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

استكشاف الأخطاء وإصلاحها

إذا تلقيت هذا الخطأ "حجم الطلب كبير جدًا. يرجى تقليل حجم بيانات الإدخال والمحاولة مرة أخرى."، اتبع الخطوات التالية:

  • تقليل حجم الإدخال - اختبر الاستعلام باستخدام ملف عينة أصغر حجمًا أو مع نطاق زمني أصغر.
  • تقليل حجم الاستعلام - لاختبار تحديد استعلام، حدد جزءًا من الاستعلام ثم انقر فوق اختبار الاستعلام المحدد.

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