البرنامج التعليمي: استخدام مواضيع مساحة الاسم لتوجيه رسائل MQTT إلى Azure Event Hubs (مدخل Microsoft Azure)

في هذا البرنامج التعليمي، ستتعلم كيفية استخدام موضوع مساحة الاسم لتوجيه البيانات من عملاء MQTT إلى Azure Event Hubs. فيما يلي الخطوات عالية المستوى:

المتطلبات الأساسية

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

إنشاء مساحة اسم في مدخل Microsoft Azure

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

يرجى اتباع الأقسام التالية لإنشاء مساحة اسم Azure Event Grid وعرضها وإدارتها.

لإنشاء مساحة اسم:

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

  2. في مربع البحث، أدخل Event Grid Namespaces وحدد Event Grid Namespaces من النتائج.

    لقطة شاشة تعرض مساحات أسماء شبكة الأحداث في نتائج البحث.

  3. في صفحة مساحات أسماء شبكة الأحداث، حدد + إنشاء على شريط الأدوات.

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

  4. في صفحة الأساسيات ، اتبع الخطوات التالية.

    1. حدد اشتراك Azure الذي تريد إنشاء مساحة الاسم فيه.

    2. قم باختيار مجموعة موارد، أو تحديد مجموعة موارد موجودة.

    3. أدخل name لمساحة الاسم.

    4. حدد المنطقة أو الموقع الذي تريد إنشاء مساحة الاسم فيه.

    5. حدد مراجعة + إنشاء عند أسفل الصفحة.

      لقطة شاشة تعرض علامة التبويب Basics في صفحة Create namespace.

  5. في علامة التبويب مراجعة + إنشاء ، راجع الإعدادات وحدد إنشاء.

  6. في صفحة Deployment succeeded ، حدد Go to resource للانتقال إلى مساحة الاسم الخاصة بك.

إنشاء موضوع مساحة الاسم

  1. إذا لم تكن في صفحة event Grid Namespace، فاتبع خطوات إنشاء مساحات الأسماء وعرضها وإدارتها لعرض مساحة الاسم التي تريد استخدامها لإنشاء الموضوع.

  2. في صفحة Event Grid Namespace ، حدد خيار Topics في قسم Event broker في القائمة اليسرى.

  3. في الصفحة مواضيع ، حدد الزر + موضوع على شريط الأوامر.

    لقطة شاشة تعرض إنشاء موضوع مساحة اسم شبكة الأحداث.

  4. في صفحة إنشاء موضوع ، اكتب اسم الموضوع الذي تريد إنشاءه وحدد إنشاء.

    لقطة شاشة تعرض أساسيات إنشاء موضوع مساحة اسم شبكة الأحداث.

تمكين الهوية المدارة لمساحة اسم شبكة الأحداث

  1. في صفحة Event Grid Namespace ، حدد Identity ضمن Settings في القائمة اليسرى.

  2. قم بتشغيل التبديل لتمكين هوية مدارة معينة من قبل النظام.

  3. في شريط الأدوات، حدد Save لحفظ الإعدادات.

    لقطة شاشة لصفحة هوية معينة من قبل النظام لمساحة اسم شبكة الأحداث.

  4. حدد Yes في رسالة التأكيد.

  5. تأكد من أنك ترى معرّف الكائن للهوية المدارة المعينة من قبل النظام وسترى ارتباطًا لتعيين الأدوار.

    لقطة شاشة تظهر اكتمال تعيين الهوية إلى مساحة اسم.

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

تمكين وسيط MQTT لمساحة اسم شبكة الأحداث

  1. في صفحة Event Grid Namespace ، حدد Configuration ضمن Settings في القائمة اليسرى.

  2. حدد خانة الاختيار بجوار تمكين وسيط MQTT.

  3. حدد تطبيق في أسفل الصفحة.

    لقطة شاشة تعرض صفحة تكوين مساحة اسم شبكة الأحداث لتمكين MQTT.

    تحقق من الإعلامات في المدخل للتأكد من تمكين وسيط MQTT لمساحة الاسم.

في علامة تبويب منفصلة من مستعرض ويب أو في نافذة منفصلة، استخدم مدخل Microsoft Azure لإنشاء مساحة اسم مراكز الأحداث مع مركز أحداث.

إنشاء مساحة اسم مراكز الأحداث

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

  1. في مدخل Microsoft Azure، حدد All services في القائمة اليسرى، وحدد star (*) بجوار Event Hubs في فئة Analytics . تأكد من إضافة مراكز الأحداث إلى المفضلة في قائمة التنقل اليسرى.

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

  2. حدد مراكز الأحداث ضمن المفضلة في قائمة التنقل اليسرى، وحدد إنشاء على شريط الأدوات.

    لقطة شاشة تعرض تحديد الزر

  3. في صفحة Create namespace ، اتبع الخطوات التالية:

    1. حدد الاشتراك الذي تريد إنشاء مساحة الاسم فيه.

    2. حدد مجموعة الموارد التي أنشأتها في الخطوة السابقة.

    3. أدخل name لمساحة الاسم. يتحقق النظام على الفور لمعرفة ما إذا كان الاسم متوفرًا.

    4. حدد location لمساحة الاسم.

    5. اختر Basic لطبقة التسعير. إذا كنت تخطط لاستخدام مساحة الاسم من تطبيقات Apache Kafka ، فاستخدم المستوى القياسي . لا يدعم المستوى الأساسي أحمال عمل Apache Kafka. للتعرف على الاختلافات بين المستويات، راجع مقالات الحصص النسبية والحدود ومراكز الأحداث المتميزة ومراكز الأحداث المخصصة .

    6. اترك إعدادات وحدات معدل النقل (للمستوى القياسي) أو وحدات المعالجة (للطبقة المتميزة) كما هي. للتعرف على وحدات معدل النقل أو وحدات المعالجة: قابلية توسع مراكز الأحداث.

    7. حدد Review + Create في أسفل الصفحة.

      لقطة شاشة لصفحة إنشاء Namespace في مدخل Microsoft Azure.

    8. في صفحة Review + Create ، راجع الإعدادات، وحدد Create. انتظر حتى يكتمل التوزيع.

  4. في صفحة Deployment ، حدد Go to resource للانتقال إلى صفحة مساحة الاسم الخاصة بك.

    لقطة شاشة لصفحة اكتمال النشر مع الارتباط إلى المورد.

  5. تأكد من رؤية صفحة مراكز الأحداث Namespace مشابهة للمثال التالي:

    لقطة شاشة للصفحة الرئيسية لمساحة اسم Event Hubs في مدخل Microsoft Azure.

إنشاء مركز أحداث

لإنشاء مركز حدث ضمن مساحة الاسم، اتبع الإجراءات التالية:

  1. في صفحة Overview ، حدد + Event hub على شريط الأوامر.

    لقطة شاشة لتحديد زر Add event hub على شريط الأوامر.

  2. اكتب اسما لمركز الأحداث، ثم حدد Review + create.

    لقطة شاشة لصفحة Create event hub.

  3. في صفحة مراجعة+ إنشاء حدد إنشاء.

  4. يمكنك التحقق من حالة إنشاء مركز الحدث من خلال التنبيهات. بعد إنشاء مركز الحدث، ستجده معروضًا في قائمة مراكز الحدث.

    لقطة شاشة تعرض قائمة مراكز الأحداث.

منح مساحة اسم شبكة الأحداث حق الوصول لإرسال الأحداث إلى مركز الأحداث

  1. في صفحة Event Hubs Namespace ، حدد Access control (IAM) في القائمة اليسرى.

  2. في صفحة التحكم بالوصول، حدد + إضافة على شريط الأوامر، ثم حدد إضافة تعيين دور.

    لقطة شاشة تعرض صفحة التحكم في الوصول لمساحة اسم مراكز الأحداث.

  3. في صفحة Add role assignment ، حدد Azure Event Hubs Data Sender من قائمة الأدوار، ثم حدد Next في أسفل الصفحة.

    لقطة شاشة تعرض صفحة إضافة تعيين دور مع تحديد Azure Event Hubs Data Sender.

  4. في صفحة الأعضاء ، اتبع الخطوات التالية:

    1. بالنسبة للحقل تعيين الوصول إلى ، حدد الهوية المدارة.

    2. اختر + Select members.

      لقطة شاشة تعرض صفحة إضافة تعيين دور مع تحديد الهوية المدارة.

  5. في صفحة تحديد الهويات المدارة ، اتبع الخطوات التالية:

    1. حدد اشتراك Azure الخاص بك.

    2. بالنسبة للهوية المدارة، حدد Event Grid Namespace.

    3. حدد الهوية المدارة التي لها نفس اسم مساحة اسم شبكة الأحداث.

    4. اختر تحديد في أسفل الصفحة.

      لقطة شاشة تعرض صفحة تحديد الهويات المدارة مع تحديد الهوية المدارة لمساحة اسم شبكة الأحداث.

  6. في صفحة إضافة تعيين دور، حدد مراجعة + تعيين في أسفل الصفحة.

  7. في صفحة Review + assign ، حدد Review + assign.

إنشاء اشتراك حدث باستخدام Event Hubs كنقطة نهاية

  1. قم بالتبديل إلى علامة تبويب نافذة مستعرض ويب التي تحتوي على مساحة اسم شبكة الأحداث مفتوحة.

  2. في صفحة Event Grid Namespace ، حدد Topics في القائمة اليسرى.

  3. في صفحة Topics ، حدد موضوع مساحة الاسم الذي أنشأته سابقا.

    لقطة شاشة تعرض صفحة

  4. في صفحة Event Grid Namespace Topic ، حدد + Subscription على شريط الأوامر في الأعلى.

    لقطة شاشة تعرض صفحة الاشتراكات.

  5. في صفحة إنشاء اشتراك ، اتبع الخطوات التالية:

    1. أدخل اسماً للاشتراك في الحدث.

    2. بالنسبة إلى وضع التسليم، حدد Push.

    3. تأكد من تعيين نوع نقطة النهاية إلى مركز الأحداث.

    4. حدد تكوين نقطة نهاية.

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

    5. في Select Event Hub، اتبع الخطوات التالية:

      1. حدد اشتراك Azure الذي يحتوي على مركز الحدث.

      2. حدد مجموعة الموارد التي تحتوي على مركز الحدث.

      3. حدد مساحة اسم مراكز الأحداث.

      4. حدد مركز الأحداث في مساحة اسم مراكز الأحداث.

      5. ثم حدد تأكيد التحديد.

        لقطة شاشة تعرض صفحة تحديد مركز الحدث.

    6. مرة أخرى في صفحة إنشاء اشتراك، حدد النظام المعين لنوع الهوية المدارة.

    7. حدد "Create" من أسفل الصفحة.

      لقطة شاشة تعرض صفحة إنشاء اشتراك مع تحديد الزر إنشاء.

تكوين التوجيه في مساحة اسم شبكة الأحداث

  1. انتقل مرة أخرى إلى صفحة Event Grid Namespace عن طريق تحديد مساحة الاسم في قسم Essentials في صفحة Event Grid Namespace Topic أو عن طريق تحديد اسم مساحة الاسم في قائمة التنقل في الأعلى.

  2. في صفحة Event Grid Namespace ، حدد التوجيه في القائمة اليسرى في قسم وسيط MQTT.

  3. في صفحة التوجيه ، حدد تمكين التوجيه.

  4. بالنسبة إلى Topic type، حدد Namespace topic.

  5. بالنسبة إلى الموضوع، حدد موضوع مساحة اسم شبكة الأحداث الذي قمت بإنشائه حيث سيتم توجيه جميع رسائل MQTT.

  6. حدد تطبيق.

    لقطة شاشة تعرض صفحة التوجيه مع تحديد موضوع مساحة الاسم.

    تحقق من الإعلامات للتأكد من تمكين مساحة الاسم بمعلومات التوجيه.

إنشاء العملاء ومساحة الموضوع وروابط الأذونات

اتبع الخطوات في التشغيل السريع: نشر موضوع MQTT والاشتراك فيه من أجل:

  1. إنشاء عميل. يمكنك إنشاء العميل الثاني إذا كنت تريد ذلك، ولكنه اختياري.

  2. إنشاء مساحة موضوع.

  3. إنشاء روابط أذونات الناشر والمشترك.

  4. استخدم MQTTX لإرسال بعض الرسائل.

  5. تحقق من أن مركز الأحداث تلقى هذه الرسائل في صفحة نظرة عامة لمساحة اسم مراكز الأحداث.

    لقطة شاشة تعرض صفحة نظرة عامة لمركز الأحداث مع عدد الرسائل الواردة.

عرض رسائل MQTT التي تم توجيهها في مراكز الأحداث باستخدام استعلام Stream Analytics

انتقل إلى مثيل مراكز الأحداث (مركز الأحداث) ضمن اشتراك الحدث في مدخل Microsoft Azure. معالجة البيانات من مركز الأحداث باستخدام Stream Analytics. لمزيد من المعلومات، راجع معالجة البيانات من Azure Event Hubs باستخدام Stream Analytics - Azure Event Hubs | Microsoft Learn. يمكنك مشاهدة رسائل MQTT في الاستعلام.

لقطة شاشة تعرض بيانات رسائل MQTT في مراكز الأحداث باستخدام أداة استعلام Stream Analytics.

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

للحصول على نماذج التعليمات البرمجية، انتقل إلى مستودع GitHub هذا.