قراءة الرسائل من جهاز إلى سحابة من نقطة النهاية المضمنة
بشكل افتراضي، يتم توجيه الرسائل إلى نقطة النهاية المضمنة التي تواجه الخدمة (الرسائل/الأحداث) المتوافقة مع مراكز الأحداث. يتم حاليا عرض نقطة النهاية هذه فقط باستخدام بروتوكول AMQP على المنفذ 5671 وAMQP عبر WebSockets على المنفذ 443. يعرض مركز إنترنت الأشياء الخصائص التالية لتمكينك من التحكم في رسائل/أحداث نقطة نهاية المراسلة المضمنة المتوافقة مع مركز الأحداث.
| الخاصية | الوصف |
|---|---|
| عدد الأقسام | قم بتعيين هذه الخاصية عند الإنشاء لتحديد عدد الأقسام الخاصة باستيعاب الأحداث من الجهاز إلى السحابة. |
| وقت الاستبقاء | تحدد هذه الخاصية المدة التي يتم فيها الاحتفاظ بالرسائل بالأيام بواسطة IoT Hub. الإعداد الافتراضي هو يوم واحد، ولكن يمكن زيادته إلى سبعة أيام. |
يسمح IoT Hub بالاحتفاظ بالبيانات في مراكز الأحداث المضمنة لمدة أقصاها 7 أيام. يمكنك تعيين وقت الاستبقاء أثناء إنشاء IoT Hub. يعتمد وقت استبقاء البيانات في IoT Hub على مستوى IoT hub ونوع الوحدة. من حيث الحجم، يمكن لمراكز الحدث المضمنة الاحتفاظ بالرسائل ذات الحد الأقصى لحجم الرسالة حتى 24 ساعة على الأقل من الحصة النسبية. على سبيل المثال، بالنسبة لوحدة واحدة S1، يوفر IoT Hub مساحة تخزين كافية للاحتفاظ بما لا يقل عن 400 ألف رسالة بحجم 4 كيلوبايت لكل منها. إذا كانت أجهزتك ترسل رسائل أصغر، فقد يتم الاحتفاظ بها لفترة أطول (حتى 7 أيام) اعتمادًا على كمية التخزين المستهلكة. نحن نضمن الاحتفاظ بالبيانات لوقت الاستبقاء المحدد كحد أدنى. ستنتهي صلاحية الرسائل ولن يمكن الوصول إليها بعد انقضاء وقت الاحتفاظ.
يتيح لك IoT Hub أيضًا إدارة مجموعات المستهلكين على نقطة النهاية المضمنة للاستقبال من الأجهزة إلى السحابة. يمكنك الحصول على ما يصل إلى 20 مجموعة من المستهلكين لكل IoT Hub.
إذا كنت تستخدم توجيه الرسائل وتم تمكين المسار الاحتياطي، فستنتقل جميع الرسائل التي لا تتطابق مع استعلام على أي مسار إلى نقطة النهاية المضمنة. إذا قمت بتعطيل هذا التوجيه البديل، يتم إفلات الرسائل التي لا تتطابق مع أي استعلام.
يمكنك تعديل وقت الاستبقاء، إما برمجيا باستخدام واجهات برمجة تطبيقات REST لموفر موارد IoT Hub، أو باستخدام مدخل Azure.
يعرض IoT Hub نقطة النهاية المضمنة في الرسائل/الأحداث لخدماتك الخلفية لقراءة الرسائل من الجهاز إلى السحابة التي يتلقاها مركزك. نقطة النهاية هذه متوافقة مع "مركز الحدث"، والتي تمكنك من استخدام أي من الآليات التي تدعمها خدمة "مراكز الأحداث" لقراءة الرسائل.
القراءة من نقطة النهاية المضمنة
بعض عمليات تكامل المنتج وSDKs "مراكز الأحداث" على دراية بـ IoT Hub وتتيح لك استخدام سلسلة اتصال خدمة IoT hub للاتصال بنقطة النهاية المضمنة.
عند استخدام SDKs "مراكز الأحداث" أو عمليات تكامل المنتج التي ليست على دراية بـ IoT Hub، تحتاج نقطة نهاية متوافقة مع "مركز الحدث" واسم متوافق مع "مركز الحدث". يمكنك استرداد هذه القيم من البوابة الإلكترونية كما يلي:
سجل الدخول إلى مدخل Azure وانتقل إلى مركز إنترنت الأشياء.
انقر فوق نقاط النهاية المضمنة.
يحتوي قسم الأحداث على القيم التالية: الأقساموالاسم المتوافق مع مركز الأحداث ونقطة النهاية المتوافقة مع مركز الأحداثووقت الاحتفاظ ومجموعاتالمستهلكين.
في البوابة الإلكترونية، يحتوي حقل نقطة النهاية المتوافقة مع مركز الأحداث على سلسلة اتصال "مراكز تنظيم الأحداث" كاملة تبدو كما يلي: Endpoint=sb://abcd1234namespace.servicebus.windows.net/; SharedAccessKeyName=iothubowner; SharedAccessKey=keykeykeykeykeykey=; EntityPath=iothub-ehub-abcd-1234-123456. إذا تطلب SDK الذي تستخدمه قيمًا أخرى، فستكون:
| الاسم | القيمة |
|---|---|
| نقطة النهاية | sb://abcd1234namespace.servicebus.windows.net/ |
| اسم المضيف | abcd1234namespace.servicebus.windows.net |
| مساحة الاسم | abcd1234namespace |
يمكنك بعد ذلك اختيار أي سياسة وصول مشترك من القائمة المنسدلة كما هو موضح في لقطة الشاشة أعلاه. يعرض فقط النهج التي لديها أذونات ServiceConnect للاتصال بمركز الأحداث المحدد.
تتضمن SDKs التي يمكنك استخدامها للاتصال بنقطة النهاية المتوافقة مع "مركز الحدث" المضمنة التي يكشفها IoT Hub:
تتضمن عمليات تكامل المنتج التي يمكنك استخدامها مع نقطة النهاية المتوافقة مع "مركز الحدث" المضمنة التي يكشفها IoT Hub:
- Azure Functions. راجع روابط Azure IoT Hub لوظائف Azure.
- Azure Stream Analytics. راجع دفق البيانات كإدخال في Stream Analytics.
- Insights السلاسل الزمنية. راجع إضافة مصدر أحداث مركز إنترنت الأشياء إلى بيئة Insights السلاسل الزمنية.
- أباتشي العاصفة صنبور. يمكنك عرض مصدر صنبور على GitHub.
- تكامل أباتشي سبارك.
- أباتشي كافكا. لمزيد من المعلومات، راجع دليل مطوري Apache Kafka لمراكز الأحداث.
- Azure Databricks.
استخدام AMQP-WS أو وكيل مع مجموعات SDK لمراكز الأحداث
يمكنك استخدام مجموعات تطوير البرامج (SDK) لمراكز الأحداث للقراءة من نقطة النهاية المضمنة في البيئات التي تتطلب AMQP عبر WebSockets أو القراءة من خلال وكيل. لمزيد من المعلومات، راجع العينات التالية.
| اللغة | العينة |
|---|---|
| .NET | ReadD2cMessages .NET |
| Java | قراءة-d2c-رسائل جافا |
| Node.js | قراءة d2c الرسائل Node.js |
| Python | قراءة رسائل ديسمبر بايثون |
الخطوات التالية
لمزيد من المعلومات حول نقاط نهاية IoT Hub، راجع نقاط نهاية IoT Hub.
يوضح لك Quickstarts كيفية إرسال رسائل من الجهاز إلى السحابة من الأجهزة المحاكية وقراءة الرسائل من نقطة النهاية المضمنة.
لمزيد من التفاصيل، راجع البرنامج التعليمي لمعالجة رسائل IoT Hub من جهاز إلى سحابة باستخدام المسارات .
- إذا كنت تريد توجيه الرسائل من الجهاز إلى السحابة إلى نقاط نهاية مخصصة، فراجع استخدام مسارات الرسائل ونقاط النهاية المخصصة للرسائل من الجهاز إلى السحابة.