مشاركة عبر

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

  • مقالة

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

إشعار

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

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

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

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

هام

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

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

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

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

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

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

    Screenshot of left side navigation, where entity can be selected.

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

    Screenshot of the Queues page with a specific queue selected.

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

    Screenshot of queue page where Service Bus Explorer can be selected.

    إشعار

    عند المعاينة السريعة أو الاستلام من اشتراك، حدد أولاً "Subscription" المحدد من محدد القائمة المنسدلة. Screenshot of dropdown for topic subscriptions.

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

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

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

    Screenshot of dropdown with Peek Mode selected.

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

    Screenshot of queue and dead-letter subqueue tabs with message metrics displayed.

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

    Screenshot indicating the Peek from start button.

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

    Screenshot with overview of peeked messages and message body content shown for peeked messages.

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

    Screenshot with overview of peeked messages and message properties shown for peeked messages.

    إشعار

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

    إشعار

    لأسباب تتعلق بالأداء، عند ظهور رسائل خاطفة من قائمة انتظار أو اشتراك بلغ الحد الأقصى لحجم الرسالة فيه 1 ميغابايت، فلن يتم استرداد نص الرسالة افتراضيًا. بدلا من ذلك، يمكنك تحميل نص الرسالة لرسالة معينة بالنقر فوق الزر Load message body. إذا تجاوز نص الرسالة أكثر من 1 ميغابايت، فسيتم اقتطاعه قبل عرضه. Screenshot with overview of peeked messages and button to load message body shown.

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

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

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

    Screenshot of dropdown with Peek Mode selected for peek with advanced options.

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

    Screenshot of queue and dead-letter subqueue tabs with message metrics displayed for peek with advanced options.

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

    Screenshot indicating the Peek with options button, and a page where the options can be set.

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

    Screenshot with overview of peeked messages and message body content shown for peek with advanced options.

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

    Screenshot with overview of peeked messages and message properties shown for peek with advanced options.

    إشعار

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

استلام رسالة

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

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

    Screenshot of dropdown with Receive Mode selected.

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

    Screenshot of queue and dead-letter subqueue tabs with message metrics displayed for receive mode.

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

    Screenshot indicating the Receive button, and a page where the options can be set.

    هام

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

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

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

    Screenshot with overview of received messages and message body content shown.

    Screenshot with overview of received messages and message properties shown.

    إشعار

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

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

إشعار

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

إكمال رسالة

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

  2. حدد زر "Complete".

    Screenshot indicating the Complete button.

    هام

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

تأجيل رسالة

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

  2. حدد زر "Defer".

    Screenshot indicating the Defer button.

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

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

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

    Screenshot indicating the Abandon Lock button.

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

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

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

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

    Screenshot indicating the Dead-letter button.

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

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

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

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

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

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

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

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

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

    Screenshot showing the compose message experience.

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

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

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

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

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

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

    Screenshot indicating the Resend selected messages button.

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

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

    Screenshot showing the resend messages experience.

    إشعار

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

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

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

  1. حدد زر "Settings".

    Screenshot indicating the Settings button in Service Bus Explorer.

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

    Screenshot indicating the Settings button and a page showing the different authentication types.

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