التشغيل السريع: تصدير البيانات من تطبيق IoT المركزي

في هذا التشغيل السريع، يمكنك تكوين تطبيق IoT Central لتصدير البيانات Azure Data Explorer. يتيح لك Azure Data Explorer تخزين القياس عن بعد والاستعلام عنه ومعالجته من أجهزة مثل تطبيق IoT أجهزة التوصيل و التشغيل الذكي.

في هذه البداية السريعة، قمت بـ:

• استخدم ميزة تصدير البيانات في IoT Central إلى بيانات تتبع الاستخدام من تطبيق الهاتف الذكي إلى قاعدة بيانات Azure Data Explorer.
• استخدم Azure Data Explorer لتشغيل الاستعلامات على بيانات تتبع الاستخدام.

يتطلب إكمال هذا التشغيل السريع تكلفة صغيرة في حساب Azure الخاص بك لمثيل Azure Data Explorer. أول جهازين في تطبيق IoT Central مجانيان.

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

• حساب Azure مع اشتراك نشط. أنشئ حساباً مجاناً.
• أكمل التشغيل السريع الأول إنشاء تطبيق Azure IoT Central. يكون التشغيل السريع الثاني وتكوين القواعد والإجراءات الخاصة بجهازك اختيارية.
• تحتاج إلى بادئة عنوان URL لتطبيق IoT Central التي اخترتها في التشغيل السريع الأول إنشاء تطبيق Azure IoT Central.

• استخدم بيئة Bash في Azure Cloud Shell. لمزيد من المعلومات، راجع التشغيل السريع ل Bash في Azure Cloud Shell.

  

• إذا كنت تفضل تشغيل أوامر مرجع CLI محلياً قم بتثبيت CLI Azure. إذا كنت تعمل على نظام تشغيل Windows أو macOS، ففكر في تشغيل Azure CLI في حاوية Docker. لمزيد من المعلومات، راجع كيفية تشغيل Azure CLI في حاوية Docker.

  • إذا كنت تستخدم تثبيت محلي، يُرجى تسجيل الدخول إلى Azure CLI مستخدمًا أمر az login. لإنهاء عملية المصادقة، اتبع الخطوات المعروضة في جهازك. للحصول على خيارات أخرى لتسجيل دخول، راجع تسجيل الدخول باستخدام Azure CLI.

  • عندما يُطلب منك، قم بتثبيت ملحق Azure CLI عند الاستخدام لأول مرة. لمزيد من المعلومات بشأن الامتدادات، راجع استخدام امتدادات مع Azure CLI.

  • يُرجى تشغيل إصدار az للوصول إلى الإصدار والمكتبات التابعة التي تم تثبيتها. للتحديث لآخر إصدار، يُرجى تشغيل تحديث az.

تثبيت خدمات Azure

قبل أن تتمكن من تصدير البيانات من تطبيق IoT Central، تحتاج إلى نظام مجموعة وقاعدة بيانات Azure Data Explorer. في هذا التشغيل السريع، يمكنك تشغيل برنامج نصي bash في Azure Cloud Shell لإنشائها وتكوينها.

البرنامج النصي يكمل الخطوات التالية:

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

قم بتشغيل الأوامر التالية لتنزيل البرنامج النصي إلى بيئة Azure Cloud Shell:

wget https://raw.githubusercontent.com/Azure-Samples/iot-central-docs-samples/main/quickstart-cde/createADX.sh
chmod u+x createADX.sh

استخدم الأمر التالي لتشغيل البرنامج النصي:

• استبدل CLUSTER_NAME باسم فريد لنظام مجموعة Azure Data Explorer. يمكن أن يحتوي اسم نظام المجموعة على أحرف صغيرة وأرقام فقط. يجب أن يتراوح طول اسم نظام المجموعة بين 4 و22 حرفا.
• استبدل CENTRAL_URL_PREFIX ببادئة URL التي اخترتها في التشغيل السريع الأول لتطبيق IoT Central.
• عند مطالبتك، اتبع الإرشادات لتسجيل الدخول إلى حسابك. من الضروري أن يقوم البرنامج النصي بتسجيل الدخول لأنه ينشئ رمزا مميزا لحامله لمصادقة استدعاء REST API.

./createADX.sh CLUSTER_NAME CENTRAL_URL_PREFIX

هام

قد يستغرق تشغيل هذا البرنامج النصي من 20 إلى 30 دقيقة.

دون ملاحظة عن إخراج عنوان URL ل Azure Data Explorer بواسطة البرنامج النصي. يمكنكم استخدام هذه القيمة لاحقًا في البداية السريعة.

تكوين تصدير البيانات

لتكوين وجهة تصدير البيانات من IoT Central:

1. انتقل إلى صفحة تصدير البيانات في تطبيق IoT Central.
2. حدد علامة تبويب الوجهات ثم أضف وجهة.
3. أدخل Azure Data Explorer كاسم الوجهة. حدد Azure Data Explorer كنوع الوجهة.
4. في عنوان URL لنظام المجموعة، أدخل عنوان URL لمستكشف بيانات Azure الذي قمت بتدوينه مسبقا.
5. في اسم قاعدة البيانات، أدخل بيانات الهاتف.
6. في اسم الجدول، أدخل التسارع.
7. في التخويل، حدد الهوية المدارة المعينة من قبل النظام.
8. حدد حفظ.

لتكوين تصدير البيانات:

1. في صفحة تصدير البيانات، حدد علامة التبويب تصدير، ثم أضف تصدير.

2. أدخل مقياس التسارع الهاتف كاسم التصدير.

3. حدد بيانات تتبع الاستخدام كنوع البيانات المطلوب تصديرها.

4. استخدم المعلومات الموجودة في الجدول التالي لإضافة عاملي تصفية:

   الاسم	المشغل	القيمة‬
   قالب الجهاز	يساوي	IoT أجهزة التوصيل و التشغيل المحمول
   أدوات الاستشعار/التسريع/X	موجود	‏‫غير متوفر‬

   تأكد من تعيين خيار تصدير البيانات إذا كانت جميع الشروط صحيحة.

5. إضافة Azure Data Explorer كوجهة.

6. إضافة تحويل بيانات إلى الوجهة. أضف الاستعلام التالي في 2. إنشاء حقل استعلام التحويل في صفحة تحويل البيانات:

   import "iotc" as iotc;
   {
       Device: .device.id,
       EnqueuedTime: .enqueuedTime,
       X: .telemetry | iotc::find(.name == "accelerometer").value.x,
       Y: .telemetry | iotc::find(.name == "accelerometer").value.y,
       Z: .telemetry | iotc::find(.name == "accelerometer").value.z
   }
   

   

   لمعرفة كيفية عمل التحويل وتجربة الاستعلام، الصق نموذج رسالة القياس عن بعد التالية في 1. إضافة رسالة الإدخال الخاصة بك:

   {
     "messageProperties": {},
     "device": {
       "id": "8hltz8xa7n",
       "properties": {
         "reported": []
       },
       "approved": true,
       "types": [],
       "name": "8hltz8xa7n",
       "simulated": false,
       "provisioned": true,
       "modules": [],
       "templateId": "urn:modelDefinition:vlcd3zvzdm:y425jkkpqzeu",
       "templateName": "IoT Plug and Play mobile",
       "organizations": [],
       "cloudProperties": [],
       "blocked": false
     },
     "component": "sensors",
     "applicationId": "00001111-aaaa-2222-bbbb-3333cccc4444",
     "messageSource": "telemetry",
     "telemetry": [
       {
         "id": "dtmi:azureiot:PhoneSensors:__accelerometer;1",
         "name": "accelerometer",
         "value": {
           "x": 0.09960123896598816,
           "y": 0.09541380405426025,
           "z": 9.907781600952148
         }
       }
     ],
     "enqueuedTime": "2021-11-12T10:01:30.588Z",
     "enrichments": {}
   }
   

7. حفظ التحويل. ثم احفظ تعريف تصدير البيانات.

انتظر حتى تظهر حالة التصدير سليمة:

الاستعلام عن البيانات المصدرة

للاستعلام عن بيانات تتبع الاستخدام المصدرة:

1. استخدم إخراج عنوان URL ل Azure Data Explorer بواسطة البرنامج النصي الذي قمت بتشغيله مسبقا للانتقال إلى بيئة Azure Data Explorer.

2. قم بتوسيع عقدة نظام المجموعة وحدد قاعدة بيانات بيانات الهاتف. يتغير نطاق نافذة الاستعلام إلى Scope:yourclustername.eastus/phonedata.

3. في Azure Data Explorer، افتح علامة تبويب جديدة والصقها في استعلام Kusto التالي ثم حدد Run لرسم القياس عن بعد لمقياس التسارع:

['acceleration'] 
    | project EnqueuedTime, Device, X, Y, Z
    | render timechart 

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

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

إذا كنت لا تخطط لإكمال أي تشغيل سريع أو برامج تعليمية أخرى في IoT Central، فإنه يمكنك حذف تطبيق IoT Central الخاص بك:

1. في تطبيق IoT Central، انتقل إلى إدارة التطبيقات>.
2. حدد Delete ثم قم بتأكيد الإجراء الخاص بك.

لإزالة مثيل Azure Data Explorer من اشتراكك وتجنب الفوترة دون داع، احذف مجموعة موارد IoTCentralExportData-rg من مدخل Microsoft Azure أو قم بتشغيل الأمر التالي في Azure Cloud Shell:

az group delete --name IoTCentralExportData-rg

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

في التشغيل السريع، تعلمت كيفية تصدير البيانات باستمرار من IoT Central إلى خدمة Azure أخرى.

بعد أن عرفت الآن تصدير البيانات الخاصة بك، تُعد الخطوة التالية المقترحة هي:

إنشاء جهاز وتوصيله.