توجيه الأحداث داخل وخارج Azure Digital Twins

هل هذه الصفحة مفيدة؟

هل لديك ملاحظات إضافية؟

سيتم إرسال الملاحظات إلى Microsoft: بالضغط على الزر «إرسال»، سيتم استخدام ملاحظاتك لتحسين منتجات Microsoft وخدماتها. نهج الخصوصية.

تتناول هذه المقالة مسارات الأحداث وكيفية استخدام Azure Digital Twins لها لإرسال البيانات داخليا وإلى المستهلكين خارج الخدمة.

هناك حالتان رئيسيتان لإرسال بيانات Azure Digital Twins:

• إرسال البيانات من توأم واحد في الرسم البياني Azure Digital Twins إلى آخر. على سبيل المثال، عندما تتغير خاصية على أحد التوأمين الرقميين، قد تحتاج إلى إعلام التوأم الرقمي الآخر وتحديثه استنادا إلى البيانات المحدثة.
• إرسال البيانات إلى خدمات بيانات انتقال البيانات من الخادم لمزيد من التخزين أو المعالجة (المعروفة أيضا باسم خروج البيانات). على سبيل المثال، قد ترغب شركة تستخدم خرائط Azure بالفعل في استخدام Azure Digital Twins لتحسين حلها. يمكنهم تمكين Azure Map بسرعة بعد إعداد Azure Digital Twins، أو إحضار كيانات Azure Map إلى Azure Digital Twins كتوائم رقمية في الرسم البياني المزدوج، أو تشغيل استعلامات قوية باستخدام بيانات خرائط Azure وAzure Digital Twins معا.

يتم استخدام مسارات الأحداث لكلا السيناريوهين.

حول مسارات الأحداث

يتيح لك مسار الحدث إرسال بيانات الحدث من التوائم الرقمية في Azure Digital Twins إلى نقاط النهاية المحددة خصيصا في اشتراكاتك. يتم دعم ثلاث خدمات Azure حاليا لنقاط النهاية: مراكز الأحداث وشبكة الأحداثونقل خدمة Microsoft Azure. يمكن توصيل كل من خدمات Azure هذه بخدمات أخرى وتعمل كوسطاء، وإرسال البيانات إلى الوجهات النهائية مثل Insights Time Series أو خرائط Azure لأي معالجة تحتاج إليها.

ينفذ Azure Digital Twins تسليما مرة واحدة على الأقل للبيانات المنبعثة من خدمات الخروج.

يوضح الرسم التخطيطي التالي تدفق بيانات الحدث من خلال حل IoT أكبر مع جانب Azure Digital Twins:

أهداف انتقال البيانات من الخادم النموذجية لمسارات الأحداث هي موارد مثل حلول Insights خرائط Azure والتخزين والتحليلات.

مسارات الأحداث لأحداث التوأم الرقمي الداخلي

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

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

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

يحتاج مورد الحساب أيضا إلى إنشاء أذونات الأمان والوصول بشكل مستقل.

للتنقل عبر عملية إعداد دالة Azure لمعالجة أحداث التوأم الرقمي، راجع إعداد معالجة الأحداث المزدوجة إلى المزدوجة.

إنشاء نقطة النهاية

لتعريف مسار حدث، يجب على المطورين أولاً تحديد نقاط النهاية. نقطة النهاية هي وجهة خارج Azure Digital Twins تدعم اتصال المسار. تشمل الوجهات المدعومة ما يلي:

• مواضيع مخصصة لشبكة الأحداث
• مراكز الأحداث
• ناقل الخدمة

لإنشاء نقطة نهاية، يمكنك استخدام واجهات برمجة تطبيقات AZURE Digital Twins REST أو أوامر CLI أو مدخل Microsoft Azure.

عند تحديد نقطة نهاية، ستحتاج إلى توفير:

• اسم نقطة النهاية
• نوع نقطة النهاية (شبكة الأحداث أو مراكز الأحداث أو ناقل الخدمة)
• سلسلة الاتصال الأساسية وسلسلة الاتصال الثانوية للمصادقة
• مسار الموضوع لنقطة النهاية، مثل your-topic.westus2.eventgrid.azure.net

واجهات برمجة التطبيقات لنقطة النهاية المتوفرة في وحدة التحكم هي:

• إنشاء نقطة نهاية
• الحصول على قائمة بنقاط النهاية
• الحصول على نقطة النهاية حسب الاسم
• حذف نقطة النهاية حسب الاسم

إنشاء مسار الحدث

لإنشاء مسار حدث، يمكنك استخدام واجهات برمجة تطبيقات AZURE Digital Twins REST أو أوامر CLI أو مدخل Microsoft Azure.

فيما يلي مثال على إنشاء مسار حدث داخل تطبيق عميل، باستخدام CreateOrReplaceEventRouteAsync استدعاء .NET (C#) SDK:

string eventFilter = "$eventType = 'DigitalTwinTelemetryMessages' or $eventType = 'DigitalTwinLifecycleNotification'";
var er = new DigitalTwinsEventRoute("endpointName", eventFilter);
await client.CreateOrReplaceEventRouteAsync("routeId", er);

1. أولا، يتم إنشاء كائن DigitalTwinsEventRoute ، ويأخذ الدالة الإنشائية اسم نقطة نهاية. يعرف هذا endpointName الحقل نقطة نهاية مثل Event Hubs أو Event Grid أو Service Bus. يجب إنشاء نقاط النهاية هذه في اشتراكك وإرفاقها ب Azure Digital Twins باستخدام واجهات برمجة التطبيقات لمستوى التحكم قبل إجراء مكالمة التسجيل هذه.

2. يحتوي كائن مسار الحدث أيضا على حقل عامل تصفية ، والذي يمكن استخدامه لتقييد أنواع الأحداث التي تتبع هذا المسار. يمكن عامل تصفية true المسار من دون تصفية إضافية (عامل تصفية false يعطل المسار).

3. ثم يتم تمرير كائن مسار الحدث هذا إلى CreateOrReplaceEventRouteAsync، جنبا إلى جنب مع اسم للمسار.

تلميح

تأتي جميع وظائف SDK في إصدارات متزامنة وغير متزامنة.

أحداث الرسائل المهملة

عندما لا تتمكن نقطة النهاية من تسليم حدث خلال فترة زمنية معينة أو بعد محاولة تسليم الحدث عدة مرات، يمكنها إرسال الحدث الذي لم يتم تسليمه إلى حساب تخزين. تُعرف هذه العملية بالرسائل المهملة. سيقوم Azure Digital Twins بحرف غير صحيح حدث عند استيفاء أحد الشروط التالية:

• لا يتم تسليم الحدث خلال فترة البقاء
• تجاوز عدد محاولات تسليم الحدث الحد

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

قبل تعيين موقع حرف غير خامد، يجب أن يكون لديك حساب تخزين مع حاوية. يمكنك توفير عنوان URL لهذه الحاوية عند إنشاء نقطة النهاية. يتم توفير الحرف المهمم كعنون URL للحاوية مع رمز SAS المميز. يحتاج هذا الرمز المميز إلى إذن فقط write لحاوية الوجهة داخل حساب التخزين. سيكون عنوان URL الذي تم تشكيله بالكامل بتنسيق: https://<storage-account-name>.blob.core.windows.net/<container-name>?<SAS-token>

لمعرفة المزيد حول رموز SAS المميزة، راجع: منح وصول محدود إلى موارد Azure Storage باستخدام توقيعات الوصول المشترك (SAS)

لمعرفة كيفية إعداد نقطة نهاية باستخدام الكتابة غير المستخدمة، راجع إدارة نقاط النهاية والمسارات في Azure Digital Twins.

أنواع رسائل الحدث

تنتج أنواع مختلفة من الأحداث في IoT Hub وAzure Digital Twins أنواعا مختلفة من رسائل الإعلام، كما هو موضح أدناه.

نوع الإشعار	اسم مصدر التوجيه	تم إنشاؤها من...
الإعلام بتغيير النسخة المتماثلة الرقمية	الإعلام بتغيير النسخة المتماثلة الرقمية	أي تغيير في خاصية التوأم الرقمي
إعلام دورة حياة النسخة المتماثلة الرقمية	إعلام دورة حياة النسخة المتماثلة الرقمية	أي عملية إنشاء أو حذف التوأم الرقمي
إعلام بتغيير علاقة النسخة المتماثلة الرقمية	إعلام بتغيير علاقة النسخة المتماثلة الرقمية	أي تغيير في علاقة التوأم الرقمي
رسائل القياس عن بعد للنسخة المتماثلة الرقمي	رسائل القياس عن بعد	أي رسالة بيانات تتبع الاستخدام

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

تعرف على كيفية إعداد مسار حدث وإدارته:

• إدارة نقاط النهاية والمسارات

أو، راجع كيفية استخدام Azure Functions لتوجيه الأحداث داخل Azure Digital Twins:

• إعداد معالجة الأحداث المزدوجة إلى المزدوجة.