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

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

إشعار

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

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

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

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

هام

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

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

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

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

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

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

  إشعار

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

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

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

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

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

   

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

   

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

   

   إشعار

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

   إشعار

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

   "تم تعطيل الوصول إلى الشبكة العامة لمساحة الاسم. لا تعمل عمليات البيانات مثل نظرة خاطفة أو إرسال أو تلقي مقابل entit ناقل خدمة Microsoft Azure هذا حتى تقوم بالتبديل إلى جميع الشبكات أو السماح ب IP الخاص بالعميل في شبكات محددة."

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

باستخدام وظيفة النظرة الخاطفة، يمكنك استخدام 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 في أداة Service Bus Explorer.

تأجيل رسالة

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

2. حدد زر "Defer".

   

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

1. في الشبكة، حدد رسالة واحدة أو أكثر من الرسائل المستلمة التي تريد التخلي عن التأمين لها.

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

   

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

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

1. في الشبكة، حدد رسالة واحدة أو أكثر من الرسائل المستلمة التي تريدها غير مستخدمة.

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

   

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

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

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

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

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

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

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

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

3. تعيين خصائص الوسيط (اختياري). تتضمن هذه الخصائص معرف الارتباط ومعرف الرسالة والرد على التسمية/الموضوع ووقت البقاء (TTL) ووقت قائمة الانتظار المجدولة (للرسائل المجدولة).

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

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

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

   

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

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

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

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

1. في الشبكة، حدد رسالة واحدة أو أكثر تريد إعادة إرسالها.

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

   

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

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

   

   إشعار

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

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

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

1. حدد زر "Settings".

   

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

   

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

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