استخدام Service Bus Explorer لتشغيل عمليات البيانات على ناقل خدمة Microsoft Azure

يسمح ناقل خدمة Azure لتطبيقات العميل المرسل والمتلقي بفصل منطق تسلسل العمل الخاص بكل منهما باستخدام دلالات مألوفة من نقطة إلى نقطة (قائمة انتظار) ونشر الاشتراك (اشتراك الموضوعات).

إشعار

تسلط هذه المقالة الضوء على وظيفة مستكشف ناقل خدمة Azure الذي يتواجد في مدخل Azure.

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

العمليات التي يتم تشغيلها على مساحة اسم ناقل خدمة Azure من نوعين.

• عمليات الإدارة - إنشاء وتحديث وحذف مساحة اسم ناقل الخدمة وقوائم الانتظار والموضوعات والاشتراكات.
• عمليات البيانات - إرسال رسائل وتلقيها من قوائم الانتظار والموضوعات والاشتراكات.

هام

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

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

لاستخدام أداة Service Bus Explorer، تحتاج إلى القيام بالمهام التالية:

• قم بإنشاء مساحة اسم ناقل خدمة Azure

• إنشاء قائمة انتظار لإرسال رسالة وتلقيها من أو موضوع مع اشتراك لاختبار الوظيفة. لمعرفة كيفية إنشاء قوائم الانتظار والمواضيع والاشتراكات، انظر المقالات التالية:

  • التشغيل السريع: إنشاء قوائم الانتظار
  • التشغيل السريع: إنشاء موضوعات

  إشعار

  تأكد من أنك عضو في أحد هذه الأدوار على مساحة الاسم أو الكيانات التي تريد تنفيذ عمليات الإرسال أو التلقي (بما في ذلك النظرة الخاطفة والإزالة) على:

  • مالك بيانات ناقل الخدمة؛ يسمح بعمليات الإرسال والاستقبال.
  • مرسل بيانات ناقل الخدمة؛ يسمح بعمليات الإرسال.
  • جهاز استقبال بيانات ناقل الخدمة؛ يسمح بعمليات الاستلام.

استخدام مستكشف ناقل الخدمة

لاستخدام مستكشف ناقل الخدمة، انتقل إلى مساحة اسم ناقل الخدمة التي تريد تنفيذ عمليات البيانات عليها.

1. إذا كنت تتطلع إلى تشغيل العمليات مقابل قائمة انتظار، فحدد قوائم الانتظار من قائمة التنقل. إذا كنت تتطلع إلى تشغيل عمليات مقابل موضوع (والاشتراكات ذات الصلة)، فحدد المواضيع.

   

2. بعد تحديد قوائم الانتظار أو المواضيع، حدد قائمة الانتظار أو الموضوع المحدد.

   

3. حدد مستكشف ناقل خدمة Microsoft Azure من قائمة التنقل اليسرى

   

   إشعار

   عند المعاينة السريعة أو الاستلام من اشتراك، حدد أولاً "Subscription" المحدد من محدد القائمة المنسدلة.

المعاينة السريعة لرسالة

باستخدام وظيفة النظرة الخاطفة، يمكنك استخدام Service Bus Explorer لعرض أفضل 100 رسالة في قائمة انتظار أو اشتراك أو قائمة انتظار غير مستخدمة.

1. لمعاينة الرسائل سريعاً، حدد "Peek Mode" في القائمة المنسدلة لمستكشف ناقل الخدمة.

   

2. تحقق من المقاييس لمعرفة ما إذا كانت هناك رسائل نشطة أو رسائل غير مستخدمة لتدقيقها وتحديد قائمة الانتظار / الاشتراك أو قائمة الانتظار الفرعية DeadLetter .

   

3. حدد زر "Peek from start".

   

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

   

   قم بالتبديل إلى علامة التبويب خصائص الرسالة في الجزء السفلي لمشاهدة بيانات التعريف.

   

   إشعار

   نظراً لأن المعاينة السريعة ليست عملية مدمرة، لن تُحذّف الرسالة من قائمة الوحدة.

   إشعار

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

المعاينة السريعة لرسالة مع خيارات متقدمة

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

1. للمعاينة السريعة للرسائل مع الخيارات المتقدمة، حدد "Peek Mode" في القائمة المنسدلة مستكشف ناقل الخدمة.

   

2. تحقق من المقاييس لمعرفة ما إذا كانت هناك رسائل نشطة أو رسائل غير مستخدمة لتدقيقها وتحديد قائمة الانتظار / الاشتراك أو قائمة الانتظار الفرعية DeadLetter .

   

3. حدد زر "Peek with options". وفِّر عدد الرسائل المطلوب معاينته سريعاً، ورقم التسلسل المطلوب بدء المعاينة من عنده، وحدد زر "Peek".

   

4. بمجرد اكتمال عملية النظرة الخاطفة، تظهر الرسائل على الشبكة كما هو موضح في الصورة التالية. لعرض تفاصيل رسالة معينة، اخترها من الشبكة. يمكنك اختيار عرض النص الأساسي أو خصائص الرسالة.

   

   قم بالتبديل إلى علامة التبويب خصائص الرسالة في الجزء السفلي لمشاهدة بيانات التعريف.

   

   إشعار

   نظرًا لأن المعاينة السريعة ليست عملية مدمرة ، فلن تحذف الرسالة من قائمة الانتظار.

استلام رسالة

تسمح وظيفة الاستلام على مستكشف ناقل الخدمة باستلام الرسائل من قائمة انتظار أو اشتراك.

1. لاستلام الرسائل، حدد "Receive Mode" في القائمة المنسدلة مستكشف ناقل الخدمة.

   

2. افحص المقاييس لمعرفة ما إذا كانت هناك رسائل نشطة أو رسائل غير مستخدمة لاستلامها، وحدِّد إمّا "Queue / Subscription" وإمّا "DeadLetter".

   

3. حدد الزر تلقي الرسائل، وحدد وضع الاستلام، وعدد الرسائل التي يجب تلقيها، والحد الأقصى للوقت لانتظار رسالة وتحديد تلقي.

   

   هام

   يُرجى ملاحظة أن وضع ReceiveAndDelete هو استلام تدميري، أي أن الرسالة تُحذف من قائمة الانتظار عند عرضها في أداة مستكشف ناقل الخدمة.

   لاستعراض الرسائل دون حذفها من قائمة الانتظار، فكِّر في استخدام وظيفة المعاينة السريعة، أو استخدام وضع PeekLock.

4. بمجرد اكتمال عملية الاستلام، تظهر الرسائل على الشبكة كما هو موضح في الصورة التالية. لعرض تفاصيل رسالة معينة، اخترها من الشبكة.

   

   

   إشعار

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

بعد استلام رسالة في وضع PeekLock، توجد إجراءات مختلفة يمكننا اتخاذها.

إشعار

يمكننا اتخاذ هذه الإجراءات طالما يوجد تأمين على الرسالة فقط.

إكمال رسالة

1. في الشبكة، حدد الرسالة (الرسائل) المستلمة التي نريد إكمالها.

2. حدد زر "Complete".

   

   هام

   يُرجى ملاحظة أن إكمال رسالة هو استلام تدميري، أي أن الرسالة تُزاَل من قائمة الانتظار عند تحديد "Complete" في أداة مستكشف ناقل الخدمة.

تأجيل رسالة

1. في الشبكة، حدد الرسالة (الرسائل) المستلمة التي نريد تأجيلها.

2. حدد زر "Defer".

   

إلغاء التأمين

1. في الشبكة، حدد الرسالة (الرسائل) المستلمة التي نريد إلغاء تأمينها.

2. حدد زر "Abandon lock".

   

بعد إلغاء التأمين، ستتوفر الرسالة لعمليات الاستلام مرة أخرى.

قائمة غير مستخدمة

1. في الشبكة، حدد الرسالة (الرسائل) المستلمة التي نريده إدخالها في قائمة غير مستخدمة.

2. حدد زر "Dead-letter".

   

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

إزالة الرسائل

لإزالة الرسائل، حدد زر إزالة الرسائل في مستكشف ناقل خدمة Microsoft Azure.

بمجرد إدخال "التطهير" للتأكيد على العملية، سيتم إزالة الرسائل من كيان ناقل الخدمة المعني.

إرسال رسالة إلى قائمة انتظار أو موضوع

لإرسال رسالة إلى قائمة انتظار أو موضوع، حدد زر "Send messages" في مستكشف ناقل الخدمة.

1. حدد نوع المحتوى ليكون إما نصًا/عاديًا أوتطبيقًا/Xml أو تطبيقًا/Json.

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

3. اضبطخصائص الوسيط (اختياري) - وتشمل معرِّف الارتباط، ومعرِّف الرسالة، والرد إلى، والتسمية/الموضوع، ومدة البقاء، ووقت الانتظار المجدول (للرسائل المجدولة).

4. اضبط الخصائص المخصصة (اختياري) - يمكن تعيين أي خصائص للمستخدم من مفتاح قاموس.

5. تحقق من تكرار الإرسال لإرسال الرسالة نفسها عدة مرات. إذا لم يتم تعيين معرف الرسالة، يتم ملؤه تلقائيا بقيم تسلسلية.

6. بمجرد إنشاء الرسالة، حدد "Send".

   

7. عند اكتمال عملية الإرسال بنجاح، سيحدث أحد الإجراءات التالية:

   • في حالة الإرسال إلى قائمة انتظار، سيزداد عداد مقاييس الرسائل النشطة.
   • في حالة الإرسال إلى موضوع، سيزداد عداد مقاييس الرسائل النشطة على الاشتراك الذي تُوجَّه إليه الرسالة.

إعادة إرسال رسالة

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

1. في الشبكة، حدد الرسالة (الرسائل) التي نريد إعادة إرسالها.

2. حدد زر "Re-send selected messages".

   

3. يمكنك اختيارياً تحديد أي رسالة نريد تحديث تفاصيلها وإجراء التغييرات المطلوبة لها.

4. حدد الزر "Send" لإرسال الرسائل إلى الكيان.

   

   إشعار

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

تبديل نوع المصادقة

عند العمل مع Service Bus Explorer، من الممكن استخدام مفتاح الوصول أو مصادقة معرف Microsoft Entra.

1. حدد زر "Settings".

   

2. اختر طريقة المصادقة المطلوبة، وحدد الزر "Save".

   

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

• تعرف على المزيد حول قوائم انتظار وموضوعات ناقل الخدمة
• تعرف على المزيد حول إنشاء قوائم انتظار ناقل الخدمة عبر مدخل Azure
• تعرف على المزيد حول إنشاء موضوعات واشتراكات ناقل الخدمة عبر مدخل Azure