البرنامج التعليمي: استخدام مواضيع مساحة الاسم لتوجيه رسائل 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. حدد مراجعة + إنشاء عند أسفل الصفحة.

      

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 لمساحة الاسم.

في علامة تبويب منفصلة من مستعرض ويب أو في نافذة منفصلة، استخدم مدخل 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 في أسفل الصفحة.

      

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

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

   

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

   

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

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

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

   

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

   

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

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

   

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

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

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

   

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

   

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 في الاستعلام.

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

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