مشاركة عبر


التشغيل السريع: إنشاء وظيفة Azure Stream Analytics باستخدام Visual Studio

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

إشعار

  • نوصي بشدة باستخدام أدوات Stream Analytics ل Visual Studio Code للحصول على أفضل تجربة تطوير محلية. هناك فجوات معروفة في الميزات في أدوات Stream Analytics ل Visual Studio 2019 (الإصدار 2.6.3000.0) ولن يتم تحسينها من الآن فصاعدا.
  • لا تدعم أدوات Visual Studio وVisual Studio Code الوظائف في مناطق شرق الصين وشمال الصين ووسط ألمانيا وشمال شرق ألمانيا.

قبل البدء

  • إذا لم يكن لديك اشتراك Azure، فبادر بإنشاء حساب مجاني.

  • قم بتسجيل الدخول إلى بوابة Azure.

  • قم بتثبيت Visual Studio 2019 أو Visual Studio 2015 أو Visual Studio 2013 Update 4. يتم دعم إصدارات Enterprise (Ultimate/Premium) وProfessional وCommunity الإصدار السريع غير مدعوم.

  • اتبع إرشادات التثبيت لتثبيت أدوات Stream Analytics ل Visual Studio.

إعداد بيانات الإدخال

قبل تحديد وظيفة Stream Analytics، يجب عليك إعداد البيانات، والتي يتم تكوينها لاحقا كإدخال للوظيفة. لإعداد بيانات الإدخال المطلوبة من قبل الوظيفة، أكمل الخطوات التالية:

  1. قم بتسجيل الدخول إلى بوابة Azure.

  2. حدد إنشاء مورد>إنترنت الأشياء>IoT Hub.

  3. في جزء IoT Hub ، أدخل المعلومات التالية:

    الإعداد القيمة المقترحة الوصف
    الاشتراك <اشتراكك> حدد اشتراك Azure الذي تريد استخدامه.
    مجموعة الموارد asaquickstart-resourcegroup حدد إنشاء جديد وأدخل اسما جديدا لمجموعة الموارد لحسابك.
    اسم مركز إنترنت الأشياء MyASAIoTHub حدد اسما لمركز IoT الخاص بك.
    المنطقة <حدد المنطقة الأقرب إلى المستخدمين> حدد موقعا جغرافيا حيث يمكنك استضافة IoT Hub الخاص بك. استخدم الموقع الجغرافي الأقرب إلى المستخدمين.
    المستوى Free بالنسبة إلى هذا التشغيل السريع، حدد مجاني إذا كان لا يزال متاحا في اشتراكك. إذا كانت الطبقة المجانية غير متوفرة، فاختر أدنى مستوى متاح. لمزيد من المعلومات، راجع تسعير IoT Hub.

    لقطة شاشة توضح معالج إنشاء IoT Hub في مدخل Microsoft Azure.

  4. حدد "Review + create". راجع معلومات IoT Hub وحدد إنشاء. قد يستغرق إنشاء مركز IoT بضع دقائق. يمكنك مراقبة التقدم في جزء الإشعارات .

  5. بعد اكتمال النشر، حدد الانتقال إلى المورد للانتقال إلى صفحة IoT Hub لمركز IoT الخاص بك.

  6. في صفحة IoT Hub ، حدد الأجهزة ضمن إدارة الأجهزة في قائمة التنقل اليمنى.

  7. في صفحة الأجهزة ، حدد + إضافة جهاز على شريط الأدوات.

    لقطة شاشة تعرض صفحة الأجهزة مع تحديد إضافة جهاز.

  8. في صفحة إنشاء جهاز ، أدخل اسما للجهاز، وحدد حفظ.

    لقطة شاشة تعرض صفحة إنشاء جهاز.

  9. بمجرد إنشاء الجهاز، افتح الجهاز من قائمة أجهزة IoT . إذا لم يظهر لك الجهاز حتى الآن، فقم بتحديث الصفحة.

    لقطة شاشة توضح قائمة الأجهزة مع الجهاز الذي قمت بإنشائه.

  10. انسخ سلسلة الاتصال الأساسية واحفظها في مفكرة لاستخدامها لاحقا.

إنشاء تخزين كائن ثنائي كبير الحجم

  1. من الزاوية العلوية اليسرى من مدخل Microsoft Azure، حدد إنشاء حساب تخزين تخزين مورد>>.

  2. في جزء إنشاء حساب تخزين ، أدخل اسم حساب التخزين والموقع ومجموعة الموارد. اختر نفس الموقع ومجموعة الموارد مثل IoT Hub الذي قمت بإنشائه. ثم حدد مراجعة + إنشاء لإنشاء الحساب.

    لقطة شاشة توضح صفحة إنشاء حساب تخزين في مدخل Microsoft Azure.

  3. بمجرد إنشاء حساب التخزين الخاص بك، حدد لوحة خدمة Blob في جزء نظرة عامة .

    لقطة شاشة توضح صفحة نظرة عامة على حساب التخزين مع تحديد خدمة Blob.

  4. في صفحة خدمة كائن ثنائي كبير الحجم ، حدد + حاوية على شريط الأدوات.

  5. في صفحة حاوية جديدة ، أدخل اسما للحاوية الخاصة بك، مثل container1. اترك مستوى الوصول العامكخاص (لا يوجد وصول مجهول) وحدد إنشاء.

    لقطة شاشة توضح صفحة الحاوية الجديدة.

إنشاء مشروع Stream Analytics

  1. ابدأ تشغيل Visual Studio.

  2. حدد ملف > مشروع جديد.

  3. في قائمة القوالب على اليسار، حدد Stream Analytics، ثم حدد تطبيق Azure Stream Analytics.

  4. أدخل اسم المشروع والموقعواسم الحل، وحدد إنشاء.

    لقطة شاشة توضح مربع الحوار إنشاء مشروع Stream Analytics.

  5. لاحظ العناصر المضمنة في مشروع Azure Stream Analytics.

    لقطة شاشة توضح نافذة مستكشف الحلول لعينة مشروع تطبيق Stream Analytics في Visual Studio.

اختر الاشتراك المطلوب

  1. في Visual Studio، في القائمة عرض ، حدد مستكشف الخادم.
  2. انقر بزر الماوس الأيمن فوق Azure، وحدد الاتصال باشتراك Microsoft Azure، ثم قم بتسجيل الدخول باستخدام حساب Azure الخاص بك.

تحديد المدخلات

  1. في مستكشف الحلول، قم بتوسيع عقدة المدخلات وانقر نقرا مزدوجا فوق Input.json.

  2. املأ تكوين إدخال Stream Analytics بالقيم التالية:

    الإعداد القيمة المقترحة الوصف
    الاسم المستعار للإدخال Input أدخل اسما لتحديد إدخال الوظيفة.
    نوع المصدر تدفق البيانات اختر مصدر الإدخال المناسب: تدفق البيانات أو البيانات المرجعية.
    المصدر مركز IoT اختر مصدر الإدخال المناسب.
    Resource اختر مصدر البيانات من الحساب الجاري اختر إدخال البيانات يدويا أو اختر حسابا موجودا.
    الاشتراك <اشتراكك> حدد اشتراك Azure الذي يحتوي على IoT Hub الذي قمت بإنشائه.
    مركز IoT MyASAIoTHub اختر أو أدخل اسم IoT Hub الخاص بك. يتم اكتشاف أسماء IoT Hub تلقائيا إذا تم إنشاؤها في نفس الاشتراك.
  3. اترك الخيارات الأخرى للقيم الافتراضية وحدد حفظ لحفظ الإعدادات.

    لقطة شاشة توضح صفحة تكوين إدخال Stream Analytics.

تحديد المخرجات

  1. في مستكشف الحلول، قم بتوسيع عقدة المخرجات وانقر نقرا مزدوجا فوق Output.json.

  2. املأ تكوين إخراج Stream Analytics بالقيم التالية:

    الإعداد القيمة المقترحة الوصف
    الاسم المستعار للإخراج Output أدخل اسما لتحديد مخرجات الوظيفة.
    جزر تخزين بحيرة البيانات Gen 2 / تخزين Blob اختر الحوض المناسب.
    Resource توفير إعدادات مصدر البيانات يدويا اختر إدخال البيانات يدويا أو اختر حسابا موجودا.
    الاشتراك <اشتراكك> حدد اشتراك Azure الذي يحتوي على حساب التخزين الذي قمت بإنشائه. يمكن أن يكون حساب التخزين في نفس الحساب أو في اشتراك مختلف. يفترض هذا المثال أنك قمت بإنشاء حساب تخزين في نفس الاشتراك.
    حساب التخزين ASAQUICKSTARTstorage اختر أو أدخل اسم حساب التخزين. يتم اكتشاف أسماء حسابات التخزين تلقائيا إذا تم إنشاؤها في نفس الاشتراك.
    وعاء حاوية1 حدد الحاوية الموجودة التي قمت بإنشائها في حساب التخزين الخاص بك.
    نمط المسار output أدخل اسم مسار الملف المراد إنشاؤه داخل الحاوية.
  3. اترك الخيارات الأخرى للقيم الافتراضية وحدد حفظ لحفظ الإعدادات.

    لقطة شاشة توضح صفحة تكوين إخراج Stream Analytics.

حدد استعلام التحويل

  1. افتح Script.asaql من مستكشف الحلول في Visual Studio.

  2. أضف الاستعلام التالي:

    SELECT *
    INTO Output
    FROM Input
    WHERE Temperature > 27
    

إرسال استعلام Stream Analytics إلى Azure

  1. في محرر الاستعلام، حدد إرسال إلى Azure في محرر البرنامج النصي.

  2. في نافذة إرسال الوظيفة ، حدد إنشاء وظيفة Azure Stream Analytics جديدة.

  3. أدخل اسم وظيفة.

  4. اختر اشتراك Azure.

  5. اختر مجموعة الموارد.

  6. احتفظ بالقيمة الافتراضية لنظام المجموعة.

  7. حدد الموقع الذي استخدمته في بداية التشغيل السريع.

  8. ثم حدد إرسال.

    لقطة شاشة توضح مربع الحوار إرسال وظيفة.

تشغيل محاكي IoT

  1. افتح Raspberry Pi Azure IoT Online Simulator في علامة تبويب أو نافذة مستعرض جديدة.

  2. استبدل العنصر النائب في السطر 15 بسلسلة اتصال جهاز Azure IoT Hub التي قمت بحفظها في قسم سابق.

  3. حدد تشغيل. يجب أن يُظهر الإخراج بيانات المستشعر والرسائل المُرسلة إلى مركز loT الخاص بك.

    لقطة شاشة توضح Raspberry Pi Azure IoT Online Simulator.

بدء مهمة Stream Analytics والتحقق من الإخراج

  1. عند إنشاء وظيفتك، يتم فتح طريقة عرض الوظيفة تلقائيا. حدد زر السهم الأخضر لبدء المهمة ،

    لقطة شاشة توضح الزر ابدأ لبدء مهمة Stream Analytics من Visual Studio.

  2. قم بتغيير وضع بدء إخراج الوظيفة إلى JobStartTime وحدد ابدأ.

    لقطة شاشة توضح مربع الحوار تكوين وظيفة بدء تشغيل Stream Analytics.

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

    لقطة شاشة توضح حالة الوظيفة قيد التشغيل ومقاييس الوظيفة.

  4. لعرض النتائج، في القائمة عرض ، حدد Cloud Explorer، وانتقل إلى حساب التخزين في مجموعة الموارد الخاصة بك. ضمن حاويات الكائن الثنائي كبير الحجم، انقر نقرا مزدوجا فوق الحاوية 1، ثم مسار ملف الإخراج .

    عرض النتائج

تنظيف الموارد

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

  1. من القائمة اليمنى في مدخل Microsoft Azure، حدد مجموعات الموارد ثم حدد اسم المورد الذي قمت بإنشائه.
  2. في صفحة مجموعة الموارد، حدد حذف، واكتب اسم المورد المراد حذفه في مربع النص، ثم حدد حذف.

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

في هذا التشغيل السريع، قمت بنشر مهمة Stream Analytics بسيطة باستخدام Visual Studio. يمكنك أيضا نشر مهام Stream Analytics باستخدام مدخل Microsoft AzureوPowerShell.

للتعرف على أدوات Azure Stream Analytics ل Visual Studio، تابع إلى المقالة التالية: