يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
البرنامج التعليمي: إرسال بيانات الجهاز إلى Azure Storage باستخدام توجيه رسائل IoT Hub
مقالة
٠٢/١٠/١٤٤٦ هـ
استخدم توجيه الرسائل في Azure IoT Hub لإرسال بيانات تتبع الاستخدام من أجهزة IoT إلى خدمات Azure مثل تخزين الكائنات الثنائية كبيرة الحجم وقوائم انتظار ناقل الخدمة وموضوعات ناقل الخدمة ومراكز الأحداث. يحتوي كل مركز IoT على نقطة نهاية مضمنة افتراضية متوافقة مع Event Hubs. يمكنك أيضًا إنشاء نقاط نهاية مخصصة وتوجيه الرسائل إلى خدمات Azure الأخرى عن طريق تعريف استعلامات التوجيه. يتم توجيه كل رسالة تصل إلى مركز IoT إلى جميع نقاط النهاية التي يتطابق معها استعلامات التوجيه. إذا لم تتطابق الرسالة مع أي من استعلامات التوجيه المعرفة، يتم توجيهها إلى نقطة النهاية الافتراضية.
في هذا البرنامج التعليمي، تنفذ المهام التالية:
إنشاء مركز IoT وإرسال رسائل الجهاز إليه.
قم بإنشاء حساب تخزين.
إنشاء نقطة نهاية مخصصة لحساب التخزين وتوجيه الرسائل إليه من مركز IoT.
عرض رسائل الجهاز في كائن ثنائي كبير الحجم لحساب التخزين.
المتطلبات الأساسية
اشتراك Azure. في حال لم يكن لديك اشتراك Azure، فأنشئ حساباً مجانيّاً قبل البدء.
مركز IoT في اشتِراك Azure الخاص بك. إذا لم يكن لديك مركز IoT حتى الآن، يمكنك اتباع الخطوات الواردة في إنشاء مركز IoT.
قم بتنزيل أو استنساخ مستودع SDK إلى جهاز التطوير الخاص بك.
امتلك الإصدار .NET Core 3.0.0 أو إصدارًا أعلى على جهاز التطوير لديك. تحقق من الإصدار الخاص بك عن طريق تشغيل dotnet --versionوتنزيل .NET إذا لزم الأمر.
تأكد من أن المنفذ 8883 مفتوح في جدار الحماية. يستخدم نموذج الجهاز في هذا التشغيل السريع بروتوكول MQTT، الذي يتصل عبر المنفذ 8883. قد يتم حظر هذا المنفذ في بعض بيئات الشبكة التعليمية والشركات. لمزيد من المعلومات وطرق حل هذه المشكلة، راجع الاتصال ب IoT Hub.
اختياريا، قم بتثبيت Azure IoT Explorer (معاينة). تساعدك هذه الأداة على مراقبة الرسائل عند وصولها إلى مركز IoT الخاص بك. تستخدم هذه المقالة Azure IoT Explorer.
إذا كنت تفضل تشغيل أوامر مرجع CLI محلياً قم بتثبيت CLI Azure. إذا كنت تعمل على نظام تشغيل Windows أو macOS، ففكر في تشغيل Azure CLI في حاوية Docker. لمزيد من المعلومات، راجع كيفية تشغيل Azure CLI في حاوية Docker.
إذا كنت تستخدم تثبيت محلي، يُرجى تسجيل الدخول إلى Azure CLI مستخدمًا أمر az login. لإنهاء عملية المصادقة، اتبع الخطوات المعروضة في جهازك. للحصول على خيارات تسجيل الدخول الأخرى، راجع المصادقة على Azure باستخدام Azure CLI.
يُرجى تشغيل إصدار az للوصول إلى الإصدار والمكتبات التابعة التي تم تثبيتها. للتحديث لآخر إصدار، يُرجى تشغيل تحديث az.
تسجيل جهاز وإرسال الرسائل إلى IoT Hub
تسجيل جهاز جديد في IoT hub.
هام
تتضمن هذه المقالة خطوات لتوصيل جهاز باستخدام توقيع وصول مشترك، يسمى أيضا مصادقة المفتاح المتماثل. طريقة المصادقة هذه ملائمة للاختبار والتقييم، ولكن مصادقة جهاز باستخدام شهادات X.509 هي نهج أكثر أمانا. لمعرفة المزيد، راجع أفضل ممارسات الأمان لأمان الاتصال لحلول > IoT.
يجب أن يكون الجهاز الجديد في قائمة الأجهزة الآن. إذا لم يكن الأمر كذلك، فقم بتحديث الصفحة. حدد معرف الجهاز لفتح صفحة تفاصيل الجهاز.
انسخ أحد مفاتيح الجهاز واحفظها. يمكنك استخدام هذه القيمة لتكوين نموذج التعليمات البرمجية التي تنشئ رسائل محاكاة بيانات تتبع الاستخدام للجهاز.
تلميح
تستخدم العديد من أوامر CLI المستخدمة في هذا البرنامج التعليمي نفس المعلمات. لراحتك، قمنا بتحديد المتغيرات المحلية التي يمكن استدعاؤها حسب الحاجة. تأكد من تشغيل كافة الأوامر في نفس جلسة العمل، وإلا يجب عليك إعادة تعريف المتغيرات.
حدد المتغيرات لمركز IoT وجهازك.
IOTHUB_NAME: استبدل هذا العنصر النائب باسم مركز IoT الخاص بك.
DEVICE_NAME: استبدل هذا العنصر النائب بأي اسم تريد استخدامه للجهاز في هذا البرنامج التعليمي.
az iot hub device-identity create --device-id $deviceName --hub-name $hubName
من إخراج هوية الجهاز، انسخ قيمة primaryKey بدون علامات الاقتباس المحيطة واحفظها. يمكنك استخدام هذه القيمة لتكوين نموذج التعليمات البرمجية التي تنشئ رسائل محاكاة بيانات تتبع الاستخدام للجهاز.
الآن بعد أن أصبح لديك معرف الجهاز ومفتاحه، استخدم نموذج التعليمات البرمجية لبدء إرسال رسائل بيانات تتبع استخدام الجهاز إلى IoT Hub.
تلميح
إذا كنت تتبع خطوات Azure CLI لهذا البرنامج التعليمي، فقم بتشغيل نموذج التعليمات البرمجية في جلسة منفصلة. بهذه الطريقة، يمكنك السماح لمواصلة تشغيل نموذج التعليمات البرمجية أثناء اتباع باقي خطوات CLI.
من المجلد حيث قمت بتنزيل SDK أو نسخه، انتقل إلى azure-iot-sdk-csharp\iothub\device\samples\how to guides\HubRoutingSample المجلد .
تثبيت Microsoft Azure IoT SDK ل .NET والتبعيات الضرورية كما هو محدد في HubRoutingSample.csproj الملف:
dotnet restore
في محرر من اختيارك، افتح Parameters.cs الملف. يعرض هذا الملف المعلمات التي يدعمها النموذج. يتم استخدام المعلمة PrimaryConnectionString فقط في هذه المقالة عند تشغيل النموذج. راجع التعليمات البرمجية في هذا الملف. لا توجد حاجة لإجراء تغييرات.
إنشاء وتشغيل نموذج التعليمات البرمجية باستخدام الأمر التالي:
استبدل <myDevicePrimaryConnectionString> سلسلة الاتصال الأساسية من جهازك في مركز IoT.
dotnet run --PrimaryConnectionString <myDevicePrimaryConnectionString>
يجب أن تبدأ في رؤية الرسائل المطبوعة على الإخراج أثناء إرسالها إلى IoT Hub. اترك هذا البرنامج قيد التشغيل أثناء البرنامج التعليمي.
تكوين IoT Explorer لعرض الرسائل
تكوين IoT Explorer للاتصال بمركز IoT وقراءة الرسائل عند وصولها إلى نقطة النهاية المضمنة.
az iot hub connection-string show --hub-name $hubName
نسخ سلسلة الاتصال دون رموز الاقتباس المحيطة.
الآن، استخدم سلسلة الاتصال هذه لتكوين IoT Explorer لمركز IoT الخاص بك.
افتح IoT Explorer على جهاز التطوير الخاص بك.
إذا تم عرضها، فحدد Connect via IoT Hub connection string.
حدد إضافة اتصال.
ألصق سلسلة اتصال المركز في مربع النص.
حدد حفظ.
بمجرد الاتصال بمركز IoT، يجب أن تشاهد قائمة بالأجهزة. حدد معرف الجهاز الذي أنشأته لهذا البرنامج التعليمي.
حدد Telemetry.
مع استمرار تشغيل جهازك، حدد بدء. إذا لم يكن جهازك قيد التشغيل، فلن تتمكن من رؤية بيانات تتبع الاستخدام.
يجب أن تشاهد الرسائل التي تصل من جهازك، مع عرض أحدث الرسائل في الأعلى.
شاهد الرسائل الواردة لبضع لحظات للتحقق من أنك ترى ثلاثة أنواع مختلفة من الرسائل: عادية ومخزنة وحاسمة. بعد مشاهدة جميع أنواع الرسائل الثلاثة، يمكنك إيقاف جهازك.
تصل جميع هذه الرسائل إلى نقطة النهاية المضمنة الافتراضية لمركز IoT. في الأقسام التالية، سنقوم بإنشاء نقطة نهاية مخصصة وتوجيه بعض هذه الرسائل إلى التخزين استنادًا إلى خصائص الرسالة. تتوقف هذه الرسائل عن الظهور في IoT Explorer لأن الرسائل تنتقل فقط إلى نقطة النهاية المضمنة عندما لا تتطابق مع أي مسارات أخرى في مركز IoT.
إعداد مسار الرسائل
ستقوم بتوجيه الرسائل إلى موارد مختلفة بناءً على الخصائص المرفقة بالرسالة بواسطة الجهاز المحاكي. يتم إرسال الرسائل غير الموجهة بشكل مخصص إلى نقطة النهاية الافتراضية (الرسائل/الأحداث).
يعين نموذج التطبيق لهذا البرنامج التعليمي خاصية level لكل رسالة يرسلها إلى مركز IoT. يتم تعيين مستوى normal أو storage أو critical لكل رسالة بشكل عشوائي.
الخطوة الأولى هي إعداد نقطة النهاية التي يتم توجيه البيانات إليها. تتمثل الخطوة الثانية في إعداد توجيه الرسالة الذي يستخدم نقطة النهاية هذه. بعد إعداد التوجيه، يمكنك عرض نقاط النهاية، ومسارات توجيه الرسائل في المدخل.
إنشاء حساب تخزين
إنشاء حساب Azure Storage وحاوية داخل هذا الحساب، والتي تحتوي على رسائل الجهاز التي يتم توجيهها إليه.
az storage container create --auth-mode login --account-name $storageName --name $containerName
التوجيه إلى حساب التخزين
والآن قم بإعداد التوجيه لحساب التخزين. في هذا القسم، يمكنك تعريف نقطة نهاية جديدة تشير إلى حساب التخزين الذي أنشأته. بعد ذلك، يمكنك إنشاء مسار يقوم بتصفية الرسائل حيث يتم تعيين خاصية المستوى إلى التخزين، وتوجيه هذه الرسائل إلى نقطة نهاية التخزين.
ملاحظة
يمكن كتابة البيانات لتخزين blob إما بتنسيق Apache Avro، وهو الإعداد الافتراضي، أو JSON.
يمكن تعيين تنسيق الترميز فقط عند تكوين نقطة نهاية تخزين blob. لا يمكن تغيير التنسيق لنقطة نهاية تم تكوينها مسبقا. عند استخدام ترميز JSON يجب تعيين contentType إلى JSON ومحتوىEncoding إلى UTF-8 في خصائص نظام الرسالة.
لمزيد من المعلومات التفصيلية حول استخدام نقطة نهاية تخزين كائن ثنائي كبير الحجم، راجع تخزين Azure كنقطة نهاية توجيه.
هام
تتضمن هذه المقالة خطوات الاتصال بخدمة باستخدام توقيع وصول مشترك. أسلوب المصادقة هذا مناسب للاختبار والتقييم، ولكن المصادقة على خدمة باستخدام معرف Microsoft Entra أو الهويات المدارة هي نهج أكثر أمانا. لمعرفة المزيد، راجع أفضل ممارسات الأمان لأمان السحابة لحلول > IoT.
بمجرد إنشاء المسار في IoT Hub وتمكينه، يبدأ على الفور في توجيه الرسائل التي تفي بشرط الاستعلام الخاص به إلى نقطة نهاية التخزين.
مراقبة نقطة النهاية المضمنة باستخدام IoT Explorer
ارجع إلى جلسة عمل IoT Explorer على جهاز التطوير الخاص بك. تذكر أن IoT Explorer يراقب نقطة النهاية المضمنة لمركز IoT الخاص بك. وهذا يعني أنه يجب أن تشاهد الآن فقط الرسائل التي لم يتم توجيهها بواسطة المسار المخصص الذي أنشأناه.
ابدأ النموذج مرة أخرى عن طريق تشغيل التعليمات البرمجية. شاهد الرسائل الواردة لبضع لحظات ويجب أن تشاهد فقط الرسائل التي تم تعيين level فيها إلى normal أو critical.
يجب أن يكون هناك مجلد باسم مركز IoT الخاص بك. التنقل لأسفل عبر بنية الملف حتى تصل إلى ملف .json.
حدد ملف JSON، ثم حدد Download لتنزيل ملف JSON. تأكد من أن الملف يحتوي على رسائل من جهازك تم تعيين الخاصية level عليها إلى storage.
توقف عن تشغيل العينة.
تنظيف الموارد
إذا كنت ترغب في إزالة كافة موارد Azure التي استخدمتها في هذا البرنامج التعليمي، فاحذف مجموعة الموارد. يؤدي هذا الإجراء إلى حذف جميع الموارد الموجودة داخل المجموعة. إذا كنت لا تريد حذف مجموعة الموارد بأكملها، فاستخدم مدخل Microsoft Azure لتحديد موقع الموارد الفردية وحذفها.
إذا كنت تنوي الاستمرار في البرنامج التعليمي التالي، فاحتفظ بالموارد التي قمت بإنشائها هنا.
في مدخل Microsoft Azure، انتقل إلى مجموعة الموارد التي تحتوي على مركز IoT وحساب التخزين لهذا البرنامج التعليمي.
راجع جميع الموارد الموجودة في مجموعة الموارد لتحديد الموارد التي تريد تنظيفها.
إذا كنت تريد حذف كل المورد، فحدد حذف مجموعة الموارد.
إذا كنت تريد حذف مورد معين فقط، فاستخدم خانات الاختيار الموجودة بجانب كل اسم مورد لتحديد تلك التي تريد حذفها. ثم حدد حذف.
استخدم الأمر az resources list لعرض جميع الموارد في مجموعة الموارد الخاصة بك.
az resource list --resource-group $resourceGroup --output table
راجع جميع الموارد الموجودة في مجموعة الموارد لتحديد الموارد التي تريد تنظيفها.
إذا كنت تريد حذف كافة الموارد، فاستخدم الأمر az group delete.
az group delete --name $resourceGroup
إذا كنت تريد حذف موارد معينة فقط، فاستخدم الأمر az resource delete. على سبيل المثال:
az resource delete --resource-group $resourceGroup --name $storageName
الخطوات التالية
في هذا البرنامج التعليمي، تعلمت كيفية إنشاء نقطة نهاية مخصصة لمورد Azure ثم إنشاء مسار لإرسال رسائل الجهاز إلى نقطة النهاية هذه. تابع إلى البرنامج التعليمي التالي لمعرفة كيفية إثراء الرسائل ببيانات إضافية يمكن استخدامها لتبسيط معالجة انتقال البيانات من الخادم
This quickstart shows developers new to IoT Hub how to get started by using the Azure CLI to create an IoT hub, send telemetry, and view messages between a device and the hub.
توضح هذه المقالة كيفية استخدام توجيه الرسائل لإرسال رسائل من جهاز إلى سحابة. يتضمن معلومات بشأن إرسال بيانات تتبع الاستخدام وبيانات غير بيانات تتبع الاستخدام.
يوضح هذا البرنامج التعليمي لمطوري الأجهزة كيفية توصيل جهاز بأمان ب Azure IoT Hub. يمكنك استخدام SDK لجهاز Azure IoT ل C أو C# أو Python أو Node.js أو Java، لإنشاء عميل جهاز لنظام التشغيل Windows أو Linux أو Raspberry Pi (Raspbian). ثم يمكنك الاتصال وإرسال بيانات تتبع الاستخدام.
تتضمن الوثائق المفاهيمية ل Azure IoT Hub مناقشات نقاط النهاية والأمان وسجل الهوية وإدارة الجهاز والأساليب المباشرة وتوائم الجهاز وتحميلات الملفات والوظائف ولغة استعلام IoT Hub والمراسلة والعديد من الميزات الأخرى.
This article shows message enrichments, which give the IoT Hub the ability to stamp messages with additional information before the messages are sent to the designated endpoint.
Azure HPC هو قدرة سحابية مُصممة لغرض مُعين لحمل عمل الذكاء الاصطناعي وHPC، باستخدام مُعالجات رائدة والربط بين InfiniBand من فئة HPC، لتقديم أفضل أداء للتطبيق وقابلية التوسع والقيمة. تُمكن Azure HPC المستخدمين من إطلاق العنان للابتكار والإنتاجية ومرونة الأعمال التجارية، من خلال مجموعة متاحة بكثرة من تقنيات الذكاء الاصطناعي وHPC التي يمكن تخصيصها ديناميكيًا مع تغير احتياجاتك التجارية والتقنية. مسار التعلم هذا عبارة عن سلسلة من الوحدات التي تساعدك على البدء في Azure HPC - يمكنك اختيار الموضوعات التي تُهمك أو ا