مشاركة عبر

إنشاء اتصال محفوظات بيانات ل Azure Digital Twins

  • مقالة

محفوظات البيانات هي ميزة Azure Digital Twins لتكويل تحديثات الرسم البياني تلقائيا إلى Azure Data Explorer. يمكن الاستعلام عن هذه البيانات باستخدام المكون الإضافي لاستعلام Azure Digital Twins ل Azure Data Explorer للحصول على رؤى حول بيئتك بمرور الوقت.

توضح هذه المقالة كيفية إعداد اتصال محفوظات بيانات العمل بين Azure Digital Twins وAzure Data Explorer. يستخدم Azure CLI ومدخل Azure لإعداد موارد محفوظات البيانات المطلوبة وتوصيلها، بما في ذلك:

كما يحتوي على نموذج رسم بياني مزدوج يمكنك استخدامه لمشاهدة تحديثات الرسم البياني المتماثل في Azure Data Explorer.

تلميح

على الرغم من أن هذه المقالة تستخدم مدخل Microsoft Azure، يمكنك أيضا العمل مع محفوظات البيانات باستخدام إصدار 2022-05-31 من واجهات برمجة التطبيقات المتبقية.

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

إعداد البيئة الخاصة بك لـ Azure CLI

إشعار

يمكنك أيضا استخدام Azure Cloud Shell في بيئة PowerShell بدلا من بيئة Bash، إذا كنت تفضل ذلك. تتم كتابة الأوامر الموجودة في هذه الصفحة لبيئة Bash، لذلك قد تتطلب بعض التعديلات الصغيرة ليتم تشغيلها في PowerShell.

إعداد جلسة عمل CLI

لبدء العمل مع Azure Digital Twins في CLI، أول شيء يجب القيام به هو تسجيل الدخول وتعيين سياق CLI إلى اشتراكك في هذه الجلسة. قم بتشغيل هذه الأوامر في نافذة CLI:

az login
az account set --subscription "<your-Azure-subscription-ID>"

تلميح

يمكنك أيضاً استخدام اسم الاشتراك الخاص بك بدلاً من المعرف في الأمر الوارد أعلاه.

إذا كانت هذه هي المرة الأولى التي تستخدم فيها هذا الاشتراك باستخدام Azure Digital Twins، فشغل هذا الأمر للتسجيل في مساحة الاسم Azure Digital Twins. (إذا لم تكن متأكداً، فلا بأس من تشغيله مرة أخرى حتى لو كنت قد فعلت ذلك في وقت ما في الماضي.)

az provider register --namespace 'Microsoft.DigitalTwins'

بعد ذلك، ستضيف ملحق Microsoft Azure IoT ل Azure CLI، لتمكين الأوامر للتفاعل مع Azure Digital Twins وخدمات IoT الأخرى. شغل هذا الأمر للتأكد من أن لديك أحدث إصدار من الملحق:

az extension add --upgrade --name azure-iot

أنت الآن جاهز للعمل مع Azure Digital Twins في Azure CLI.

يمكنك التحقق من ذلك عن طريق تشغيل az dt --help في أي وقت لمشاهدة قائمة من أوامرAzure Digital Twins ذات المستوى الأعلى المتوفرة.

إعداد المتغيرات المحلية لجلسة CLI

توفر هذه المقالة أوامر CLI التي يمكنك استخدامها لإنشاء موارد محفوظات البيانات. لتسهيل نسخ هذه الأوامر وتشغيلها لاحقا، يمكنك إعداد المتغيرات المحلية في جلسة CLI الآن، ثم الرجوع إلى هذه المتغيرات لاحقا في أوامر CLI عند إنشاء مواردك. قم بتحديث العناصر النائبة (المحددة بأقواس <...> ) في الأوامر أدناه، وقم بتشغيل هذه الأوامر لإنشاء المتغيرات. تأكد من اتباع قواعد التسمية الموضحة في التعليقات. سيتم استخدام هذه القيم لاحقا عند إنشاء الموارد الجديدة.

إشعار

تتم كتابة هذه الأوامر لبيئة Bash. يمكن تعديلها ل PowerShell إذا كنت تفضل استخدام بيئة PowerShell CLI.

## General Setup
location="<your-resource-region>"
resourcegroup="<your-resource-group-name>"

## Azure Digital Twins Setup
# Instance name can contain letters, numbers, and hyphens. It must start and end with a letter or number, and be between 4 and 62 characters long.
dtname="<name-for-your-digital-twins-instance>"
# Connection name can contain letters, numbers, and hyphens. It must contain at least one letter, and be between 3 and 50 characters long.
connectionname="<name-for-your-data-history-connection>"

## Event Hub Setup
# Namespace can contain letters, numbers, and hyphens. It must start with a letter, end with a letter or number, and be between 6 and 50 characters long.
eventhubnamespace="<name-for-your-event-hub-namespace>"
# Event hub name can contain only letters, numbers, periods, hyphens and underscores. It must start and end with a letter or number.
eventhub="<name-for-your-event-hub>"

## Azure Data Explorer Setup
# Cluster name can contain only lowercase alphanumeric characters. It must start with a letter, and be between 4 and 22 characters long.
clustername="<name-for-your-cluster>"  
# Database name can contain only alphanumeric, spaces, dash and dot characters, and be up to 260 characters in length.
databasename="<name-for-your-database>"

# Enter a name for the table where relationship create and delete events will be stored.
relationshiplifecycletablename="<name-for-your-relationship-lifecycle-events-table>"
# Enter a name for the table where twin create and delete events will be stored.
twinlifecycletablename="<name-for-your-twin-lifecycle-events-table>"
# Optionally, enter a custom name for the table where twin property updates will be stored. If not provided, the table will be named AdtPropertyEvents.
twinpropertytablename="<name-for-your-twin-property-events-table>"

إنشاء مثيل Azure Digital Twins بهوية مدارة

إذا كان لديك بالفعل مثيل Azure Digital Twins، فتأكد من تمكين هوية مدارة معينة من قبل النظام له.

إذا لم يكن لديك مثيل Azure Digital Twins، فاتبع الإرشادات الواردة في إنشاء المثيل بهوية مدارة لإنشاء مثيل Azure Digital Twins بهوية مدارة يعينها النظام للمرة الأولى.

ثم تأكد من أن لديك دور مالك بيانات Azure Digital Twins على المثيل. يمكنك العثور على إرشادات في إعداد أذونات وصول المستخدم.

إذا كنت ترغب في إضافة اسم المثيل الخاص بك إلى متغيرات CLI المحلية بحيث يتم توصيله تلقائيا بالأوامر اللاحقة المنسخة من هذه المقالة، فقم بتخزينه في المتغير dtname مثل هذا:

dtname="<name-of-your-instance>"

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

الخطوة التالية هي إنشاء مساحة اسم Event Hubs ومركز أحداث. سيتلقى هذا المركز إشعارات دورة حياة الرسم البياني وتحديث الخاصية من مثيل Azure Digital Twins ثم إعادة توجيه الرسائل إلى نظام مجموعة Azure Data Explorer الهدف.

كجزء من إعداد اتصال محفوظات البيانات لاحقا، ستمنح مثيل Azure Digital Twins دور مالك بيانات مراكز الأحداث على مورد مركز الأحداث.

لمزيد من المعلومات حول مراكز الأحداث وقدراتها، راجع وثائق مراكز الأحداث.

إشعار

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

استخدم أوامر CLI التالية لإنشاء الموارد المطلوبة. تستخدم الأوامر العديد من المتغيرات المحلية ($locationو $eventhubnamespace$resourcegroupو و$eventhub) التي تم إنشاؤها مسبقا في إعداد المتغيرات المحلية لجلسة عمل CLI.

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

az eventhubs namespace create --name $eventhubnamespace --resource-group $resourcegroup --location $location

إنشاء مركز أحداث في مساحة الاسم الخاصة بك:

az eventhubs eventhub create --name $eventhub --resource-group $resourcegroup --namespace-name $eventhubnamespace

إنشاء نظام مجموعة وقاعدة بيانات Kusto (Azure Data Explorer)

بعد ذلك، قم بإنشاء مجموعة Kusto (Azure Data Explorer) وقاعدة بيانات لتلقي البيانات من Azure Digital Twins.

كجزء من إعداد اتصال محفوظات البيانات لاحقا، ستمنح مثيل Azure Digital Twins دور المساهم في قاعدة البيانات على الأقل (يمكن أيضا تحديد نطاقها للمجموعة)، ودور مسؤول في قاعدة البيانات.

هام

تأكد من تمكين الوصول إلى الشبكة العامة لنظام المجموعة. إذا تم تعطيل الوصول إلى الشبكة العامة لنظام مجموعة Azure Data Explorer، فلن يتمكن Azure Digital Twins من تكوين الجداول والبيانات الاصطناعية المطلوبة الأخرى، وسيفشل إعداد محفوظات البيانات.

استخدم أوامر CLI التالية لإنشاء الموارد المطلوبة. تستخدم الأوامر العديد من المتغيرات المحلية ($locationو $clustername$resourcegroupو و$databasename) التي تم إنشاؤها مسبقا في إعداد المتغيرات المحلية لجلسة عمل CLI.

ابدأ بإضافة ملحق Kusto إلى جلسة CLI، إذا لم يكن لديك بالفعل.

az extension add --name kusto

بعد ذلك، قم بإنشاء مجموعة Kusto. يتطلب الأمر أدناه من 5 إلى 10 دقائق للتنفيذ، وسينشئ مجموعة E2a v4 في طبقة المطور. يحتوي هذا النوع من نظام المجموعة على عقدة واحدة لمحرك نظام مجموعة إدارة البيانات، وينطبق على سيناريوهات التطوير والاختبار. لمزيد من المعلومات حول المستويات في Azure Data Explorer وكيفية تحديد الخيارات المناسبة لحمل عمل الإنتاج، راجع تحديد SKU الحساب الصحيح لنظام مجموعة Azure Data Explorer وتسعير Azure Data Explorer.

az kusto cluster create --cluster-name $clustername --sku name="Dev(No SLA)_Standard_E2a_v4" tier="Basic" --resource-group $resourcegroup --location $location --type SystemAssigned

إنشاء قاعدة بيانات في مجموعة Kusto الجديدة (باستخدام اسم نظام المجموعة من أعلى وفي نفس الموقع). سيتم استخدام قاعدة البيانات هذه لتخزين بيانات Azure Digital Twins السياقية. يقوم الأمر أدناه بإنشاء قاعدة بيانات مع فترة حذف مبدئية من 365 يوما، وفترة ذاكرة تخزين مؤقت ساخنة من 31 يوما. لمزيد من المعلومات حول الخيارات المتوفرة لهذا الأمر، راجع az kusto database create.

az kusto database create --cluster-name $clustername --database-name $databasename --resource-group $resourcegroup --read-write-database soft-delete-period=P365D hot-cache-period=P31D location=$location

إعداد اتصال محفوظات البيانات

الآن بعد أن قمت بإنشاء الموارد المطلوبة، استخدم الأمر في هذا القسم لإنشاء اتصال محفوظات البيانات بين مثيل Azure Digital Twins ومركز الحدث كتلة Azure Data Explorer.

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

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

إشعار

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

يستخدم الأمر أدناه المتغيرات المحلية التي تم إنشاؤها مسبقا في إعداد المتغيرات المحلية لجلسة CLI ولها العديد من المعلمات، بما في ذلك...

  • أسماء دورة حياة العلاقة وجداول دورة حياة التوأم في Azure Data Explorer (هذه المعلمات اختيارية إذا كنت لا تريد تخزين أنواع الأحداث هذه، ولكنها مطلوبة إذا كنت تريد تكرار أنواع الأحداث هذه)
  • معلمة اختيارية لتحديد اسم جدول حدث الخاصية المزدوجة (إذا لم يتم توفير هذه القيمة، فسيسمى هذا الجدول AdtPropertyEvents بشكل افتراضي). إذا كنت لا تريد تحديد اسم آخر، فقم بإزالة المعلمة --adx-property-events-table من الأمر قبل تشغيله.
  • المعلمة --adx-record-removals الاختيارية لتشغيل التكرار لحذف الخصائص المزدوجة (الأحداث التي تزيل الخصائص بالكامل)
az dt data-history connection create adx --dt-name $dtname --cn $connectionname --adx-cluster-name $clustername --adx-database-name $databasename --eventhub $eventhub --eventhub-namespace $eventhubnamespace --adx-property-events-table $twinpropertytablename --adx-twin-events-table $twinlifecycletablename --adx-relationship-events-table $relationshiplifecycletablename --adx-record-removals true

عند تنفيذ الأمر أعلاه، سيتم منحك خيار تعيين الأذونات الضرورية المطلوبة لإعداد اتصال محفوظات البيانات نيابة عنك (إذا قمت بالفعل بتعيين الأذونات الضرورية، يمكنك تخطي هذه المطالبات). يتم منح هذه الأذونات للهوية المدارة لمثيل Azure Digital Twins. الحد الأدنى للأدوار المطلوبة هو:

  • مالك بيانات مراكز الأحداث في مركز الأحداث
  • المساهم محدد النطاق على الأقل لقاعدة البيانات المحددة (يمكن أيضا تحديد نطاقه إلى نظام المجموعة)
  • تعيين قاعدة البيانات الأساسي مع مسؤول الدور (لإنشاء الجدول / الإدارة) محدد النطاق لقاعدة البيانات المحددة

بالنسبة لعملية مستوى البيانات العادية، يمكن تقليل هذه الأدوار إلى دور مرسل بيانات Azure Event Hubs واحد، إذا رغبت في ذلك.

بعد إعداد اتصال محفوظات البيانات، يمكنك اختياريا إزالة الأدوار الممنوحة لمثيل Azure Digital Twins للوصول إلى مراكز الأحداث وموارد Azure Data Explorer. لاستخدام محفوظات البيانات، الدور الوحيد الذي يحتاجه المثيل للمضي قدما هو مرسل بيانات Azure Event Hubs (أو دور أعلى يتضمن هذه الأذونات، مثل مالك بيانات مراكز الأحداث) على مورد مراكز الأحداث.

إشعار

بمجرد إعداد الاتصال، ستؤدي الإعدادات الافتراضية على مجموعة Azure Data Explorer إلى زمن انتقال استيعاب يبلغ حوالي 10 دقائق أو أقل. يمكنك تقليل زمن الانتقال هذا عن طريق تمكين استيعاب البث (أقل من 10 ثوان من زمن الانتقال) أو نهج تجميع الاستيعاب. لمزيد من المعلومات حول زمن انتقال استيعاب Azure Data Explorer، راجع زمن انتقال الاستيعاب من طرف إلى طرف.

تقييد وصول الشبكة إلى موارد محفوظات البيانات

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

للتأكد من أن موارد محفوظات البيانات الخاصة بك يمكن أن تتواصل مع بعضها البعض، يجب عليك أيضا تعديل اتصال البيانات لقاعدة بيانات Azure Data Explorer لاستخدام هوية مدارة معينة من قبل النظام.

اتبع ترتيب الخطوات أدناه للتأكد من إعداد اتصال محفوظات البيانات بشكل صحيح عندما تحتاج مواردك إلى تقليل الوصول إلى الشبكة.

  1. تأكد من تمكين التخويل المحلي على موارد محفوظات البيانات الخاصة بك (مثيل Azure Digital Twins، ومركز الأحداث، نظام مجموعة Azure Data Explorer)
  2. إنشاء اتصال محفوظات البيانات
  3. تحديث اتصال البيانات لقاعدة بيانات Azure Data Explorer لاستخدام هوية مدارة معينة من قبل النظام. في مدخل Microsoft Azure، يمكنك القيام بذلك عن طريق الانتقال إلى مجموعة Azure Data Explorer واستخدام قواعد البيانات في القائمة للانتقال إلى قاعدة بيانات محفوظات البيانات. في قائمة قاعدة البيانات، حدد اتصالات البيانات. في إدخال الجدول لاتصال محفوظات البيانات، يجب أن ترى خيار تعيين الهوية المدارة، حيث يمكنك اختيار تعيين النظام. Screenshot of the option to assign a managed identity to a data connection in the Azure portal.
  4. الآن، يمكنك تعطيل التخويل المحلي أو تعيين قيود شبكة الاتصال الأخرى للموارد المطلوبة، عن طريق تغيير إعدادات الوصول على مثيل Azure Digital Twins أو مركز الأحداث أو نظام مجموعة Azure Data Explorer.

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

فيما يلي بعض الأخطاء الشائعة التي قد تواجهها عند إعداد اتصال محفوظات البيانات وكيفية حلها.

  • إذا تم تعطيل الوصول إلى الشبكة العامة لنظام مجموعة Azure Data Explorer، فستواجه خطأ بأن الخدمة فشلت في إنشاء اتصال محفوظات البيانات، مع ظهور الرسالة "تعذر على المورد ACT بسبب خطأ خادم داخلي." سيفشل إعداد محفوظات البيانات إذا تم تعطيل الوصول إلى الشبكة العامة لنظام مجموعة Azure Data Explorer، حيث لن يتمكن Azure Digital Twins من تكوين الجداول وغيرها من البيانات الاصطناعية المطلوبة.
  • (مستخدمو CLI) إذا واجهت الخطأ "تعذر إنشاء اتصال مثيل Azure Digital Twins. تعذر إنشاء جدول وقاعدة تعيين في قاعدة البيانات. تحقق من الأذونات الخاصة بك لمستكشف قاعدة بيانات Azure وقم بتشغيل az login لتحديث بيانات الاعتماد الخاصة بك،" حل الخطأ عن طريق إضافة نفسك ك AllDatabases مسؤول ضمن Permissions في نظام مجموعة Azure Data Explorer.
  • (مستخدمو Cloud Shell) إذا كنت تستخدم Cloud Shell وواجهت الخطأ "فشل الاتصال ب MSI. يرجى التأكد من تكوين MSI بشكل صحيح،" حاول تشغيل الأمر مع تثبيت Azure CLI محلي بدلا من ذلك.

التحقق باستخدام نموذج رسم بياني مزدوج

الآن بعد إعداد اتصال محفوظات البيانات الخاص بك، يمكنك اختباره مع البيانات من التوائم الرقمية الخاصة بك.

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

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

يمكنك إعداد نموذج رسم بياني لهذا السيناريو باستخدام Azure Digital Twins Data Simulator. يقوم Azure Digital Twins Data Simulator بإنشاء توائم وعلاقات في مثيل Azure Digital Twins الخاص بك، ويدفع تحديثات الخصائص باستمرار إلى التوائم.

إنشاء رسم بياني نموذجي

يمكنك استخدام Azure Digital Twins Data Simulator لتوفير نموذج رسم بياني مزدوج ودفع تحديثات الخصائص إليه. الرسم البياني المزدوج الذي تم إنشاؤه هنا نماذج عمليات البسترة لشركة الألبان.

ابدأ بفتح Azure Digital Twins Data Simulator في متصفحك. تعيين هذه الحقول:

  • عنوان URL للمثيل: أدخل اسم المضيف لمثيل Azure Digital Twins. يمكن العثور على اسم المضيف في صفحة المدخل للمثيل الخاص بك، ويحتوي على تنسيق مثل <Azure-Digital-Twins-instance-name>.api.<region-code>.digitaltwins.azure.net.
  • نوع المحاكاة: حدد مرفق الألبان من القائمة المنسدلة.

حدد إنشاء بيئة.

Screenshot of the Azure Digital Twins Data simulator.

سترى رسائل التأكيد على الشاشة حيث يتم إنشاء النماذج والتوائم والعلاقات في بيئتك. سيؤدي هذا أيضا إلى إنشاء أحداث إنشاء العلاقة والتوائم، والتي سيتم تخزينها في Azure Data Explorer كأحداث دورة حياة مزدوجة ودورة حياة العلاقة، على التوالي.

عندما تكون المحاكاة جاهزة، سيتم تمكين زر بدء المحاكاة . مرر لأسفل وحدد بدء المحاكاة لدفع البيانات المحاكاة إلى مثيل Azure Digital Twins. لتحديث التوائم باستمرار في مثيل Azure Digital Twins، احتفظ بنافذة المستعرض هذه في المقدمة على سطح المكتب وأكمل إجراءات المستعرض الأخرى في نافذة منفصلة. سيؤدي هذا إلى إنشاء أحداث تحديثات خاصية مزدوجة باستمرار والتي سيتم تخزينها في Azure Data Explorer.

عرض التحديثات المزورة في Azure Data Explorer

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

ابدأ في مدخل Microsoft Azure وانتقل إلى مجموعة Azure Data Explorer التي أنشأتها سابقا. اختر جزء Databases من القائمة اليمنى لفتح طريقة عرض قاعدة البيانات. ابحث عن قاعدة البيانات التي أنشأتها لهذه المقالة وحدد خانة الاختيار المجاورة لها، ثم حدد استعلام.

Screenshot of the Azure portal showing a database in an Azure Data Explorer cluster.

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

Screenshot of the Azure portal showing the query view for the database. The name of the data history table is highlighted.

التحقق من إدخالات الجدول

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

.alter table <relationship-lifecycle-events-table-name> policy ingestionbatching @'{"MaximumBatchingTimeSpan":"00:00:10", "MaximumNumberOfItems": 500, "MaximumRawDataSizeMB": 1024}'

الصق الأمر في نافذة الاستعلام، واستبدل العنصر النائب باسم جدول أحداث العلاقة. حدد الزر Run لتشغيل الأمر.

Screenshot of the Azure portal showing the query view for the database. The Run button is highlighted.

كرر الأمر مرتين إضافيتين باستخدام اسم جدول أحداث دورة حياة التوأم ثم جدول تحديث الخاصية لتحديث وضع الاستيعاب للجداول الأخرى أيضا.

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

إشعار

قد يستغرق ظهور الدفعة الأولى من البيانات التي تم استيعابها ما يصل إلى 5 دقائق.

<relationship-lifecycle-events-table-name>
| count

<twin-lifecycle-events-table-name>
| count

<twin-property-updates-table-name>
| count

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

استكشاف جدول تحديثات الخصائص المزدوجة

في هذا القسم، ستقوم بمزيد من الاستكشاف باستخدام بيانات تحديث الخاصية المزدوجة الموجودة في الجدول.

أولا، قم بتشغيل الأمر التالي لعرض 100 سجل في الجدول:

<twin-property-updates-table-name>
| limit 100

بعد ذلك، قم بتشغيل استعلام استنادا إلى بيانات التوائم لمشاهدة بيانات السلسلة الزمنية السياقية.

استخدم الاستعلام أدناه لتخطيط تدفق جميع توائم آلة الملح في نموذج مصنع الألبان أوسلو. يستخدم استعلام Kusto هذا المكون الإضافي Azure Digital Twins لتحديد التوائم المهمة، وينضم إلى هذه التوائم مقابل السلسلة الزمنية لمحفوظات البيانات في Azure Data Explorer، ثم يرسم النتائج. تأكد من استبدال <ADT-instance-host-name> العنصر النائب باسم المضيف للمثيل الخاص بك، والعن <table-name> العنصر النائب باسم جدول أحداث الخاصية المزدوجة.

let ADTendpoint = "https://<ADT-instance-host-name>";
let ADTquery = ```SELECT SALT_MACHINE.$dtId as tid
FROM DIGITALTWINS FACTORY 
JOIN SALT_MACHINE RELATED FACTORY.contains 
WHERE FACTORY.$dtId = 'OsloFactory'
AND IS_OF_MODEL(SALT_MACHINE , 'dtmi:assetGen:SaltMachine;1')```;
evaluate azure_digital_twins_query_request(ADTendpoint, ADTquery)
| extend Id = tostring(tid)
| join kind=inner (<table-name>) on Id
| extend val_double = todouble(Value)
| where Key == "OutFlow"
| render timechart with (ycolumns = val_double)

يجب أن تظهر النتائج أرقام التدفقات الخارجة المتغيرة بمرور الوقت.

Screenshot of the Azure portal showing the query view for the database.

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

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

Screenshot of the Azure portal showing an Event Hubs namespace for the simulated environment.

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

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

لإنشاء لوحات معلومات Grafana التي تصور أداء عملية الألبان، اقرأ إنشاء لوحات معلومات باستخدام Azure Digital Twins وAzure Data Explorer وGrafana.

لمزيد من المعلومات حول استخدام المكون الإضافي لاستعلام Azure Digital Twins ل Azure Data Explorer، راجع الاستعلام باستخدام المكون الإضافي Azure Data Explorer ومنشور المدونة هذا. يمكنك أيضا قراءة المزيد حول المكون الإضافي هنا: الاستعلام باستخدام المكون الإضافي Azure Data Explorer.