Bagikan melalui

Menggunakan Bus Layanan Explorer untuk menjalankan operasi data pada Bus Layanan

  • Artikel

Azure Service Bus memungkinkan aplikasi klien pengirim dan penerima untuk memisahkan logika bisnis mereka dengan menggunakan semantik point-to-point (Antrean) dan terbitkan semantik (Langganan Topik).

Catatan

Artikel ini menyoroti fungsionalitas Azure Service Bus Explorer yang merupakab bagian di portal Microsoft Azure.

Service Bus Explorer sumber terbuka yang dimiliki komunitas adalah aplikasi yang berdiri sendiri dan berbeda dari yang ini.

Operasi yang dijalankan pada namespace azure Bus Layanan adalah dua jenis.

  • Operasi Manajemen - Buat, Perbarui, Hapus Bus Layanan Namespace, Topik, dan Langganan.
  • Operasi Data - Kirim ke dan Terima Pesan dari Antrean, Topik, dan Langganan.

Penting

  • Bus Layanan Explorer tidak mendukung operasi dan sesi manajemen.
  • Kami menyarankan untuk tidak menggunakan Bus Layanan Explorer untuk pesan yang lebih besar, karena ini dapat mengakibatkan batas waktu, tergantung pada ukuran pesan, latensi jaringan antara klien dan layanan Bus Layanan dll. Sebagai gantinya, kami sarankan Anda menggunakan klien Anda sendiri untuk bekerja dengan pesan yang lebih besar, di mana Anda dapat menentukan nilai batas waktu Anda sendiri.

Prasyarat

Untuk menggunakan alat Bus Layanan Explorer, Anda perlu melakukan tugas berikut:

Menggunakan Service Bus Explorer

Untuk menggunakan Service Bus Explorer, navigasikan ke namespace Service Bus tempat Anda ingin melakukan operasi data.

  1. Jika Anda ingin menjalankan operasi melawan antrean, pilih Antrean dari menu navigasi. Jika Anda ingin menjalankan operasi terhadap topik (dan langganan terkait), pilih Topik.

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

  2. Setelah memilih Antrean atau Topik, pilih antrean atau topik tertentu.

    Screenshot of the Queues page with a specific queue selected.

  3. Pilih Bus Layanan Explorer dari menu navigasi kiri

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

    Catatan

    Saat mengintip atau menerima dari langganan, pertama-tama pilih Langganan tertentu dari pemilih dropdown. Screenshot of dropdown for topic subscriptions.

Mengintip pesan

Dengan fungsionalitas intip, Anda dapat menggunakan Bus Layanan Explorer untuk melihat 100 pesan teratas dalam antrean, langganan, atau antrean surat mati.

  1. Untuk mengintip pesan, pilih Mode Peek di tarik-turun Service Bus Explorer.

    Screenshot of dropdown with Peek Mode selected.

  2. Periksa metrik untuk melihat apakah ada Pesan Aktif atau Pesan Surat Mati untuk mengintip dan pilih sub-antrean Antrean/ Langganan atau DeadLetter.

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

  3. Pilih tombol Intip dari awal.

    Screenshot indicating the Peek from start button.

  4. Setelah operasi intip selesai, hingga 100 pesan muncul di kisi seperti yang ditunjukkan pada gambar berikut. Untuk melihat detail pesan tertentu, pilih dari kisi. Anda dapat memilih untuk melihat isi atau properti pesan.

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

    Beralih ke tab Properti Pesan di panel bawah untuk melihat metadata.

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

    Catatan

    Karena mengintip bukanlah operasi yang merusak, pesan tidak akan dihapus dari entitas.

    Catatan

    Untuk alasan performa, saat mengintip pesan dari antrean atau langganan dengan pesan maksimum yang diatur lebih dari 1MB, isi pesan tidak akan diambil secara default. Sebagai gantinya, Anda dapat memuat isi pesan untuk pesan tertentu dengan mengklik tombol Muat isi pesan. Jika isi pesan lebih dari 1MB, isi pesan akan terpotong sebelum ditampilkan. Screenshot with overview of peeked messages and button to load message body shown.

Mengintip pesan dengan opsi tingkat lanjut

Mengintip dengan fungsionalitas opsi memungkinkan Anda menggunakan Bus Layanan Explorer untuk melihat pesan teratas dalam antrean, langganan, atau antrean surat mati, menentukan jumlah pesan yang akan diintip, dan nomor urut untuk memulai operasi intip.

  1. Untuk mengintip pesan dengan opsi tingkat lanjut, pilih Mode Intip di menu dropdown Service Bus Explorer.

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

  2. Periksa metrik untuk melihat apakah ada Pesan Aktif atau Pesan Surat Mati untuk mengintip dan pilih sub-antrean Antrean/ Langganan atau DeadLetter.

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

  3. Pilih tombol Intip dengan opsi. Berikan jumlah pesan yang akan diintip, dan nomor urut untuk mulai mengintip, dan pilih tombol Intip.

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

  4. Setelah operasi intip selesai, pesan muncul di kisi seperti yang ditunjukkan pada gambar berikut. Untuk melihat detail pesan tertentu, pilih dari kisi. Anda dapat memilih untuk melihat isi atau properti pesan.

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

    Beralih ke tab Properti Pesan di panel bawah untuk melihat metadata.

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

    Catatan

    Karena mengintip bukan operasi yang merusak pesan tidak akan dihapus dari antrean.

Menerima pesan

Fungsi terima pada Service Bus Explorer mengizinkan penerimaan pesan dari antrean atau langganan.

  1. Untuk menerima pesan, pilih Mode Terima di menu dropdown Service Bus Explorer.

    Screenshot of dropdown with Receive Mode selected.

  2. Periksa metrik untuk melihat apakah ada Pesan Aktif atau Pesan Dead-letter untuk diterima, dan pilih Antrian / Langganan atau DeadLetter.

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

  3. Pilih tombol Terima pesan , dan tentukan mode terima, jumlah pesan yang akan diterima, dan waktu maksimum untuk menunggu pesan dan pilih Terima.

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

    Penting

    Harap perhatikan bahwa mode ReceiveAndDelete adalah penerimaan destruktif, yaitu pesan dihapus dari antrean saat ditampilkan pada alat Service Bus Explorer.

    Untuk meramban pesan tanpa menghapusnya dari antrean, pertimbangkan untuk menggunakan fungsi Mengintip, atau menggunakan mode terima PeekLock.

  4. Setelah operasi terima selesai, pesan muncul di kisi seperti yang ditunjukkan pada gambar berikut. Untuk melihat detail pesan tertentu, pilih dari kisi.

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

    Screenshot with overview of received messages and message properties shown.

    Catatan

    Untuk alasan performa, saat menerima pesan dari antrean atau langganan dengan ukuran pesan maksimum lebih dari 1MB, hanya satu pesan yang akan diterima pada satu waktu. Jika isi pesan lebih dari 1MB, isi pesan akan terpotong sebelum ditampilkan.

Setelah pesan diterima dalam mode PeekLock, ada berbagai tindakan yang dapat kita lakukan.

Catatan

Kita hanya dapat mengambil tindakan ini selama kita memiliki kunci pada pesan.

Menyelesaikan pesan

  1. Di kisi, pilih pesan yang diterima yang ingin kami selesaikan.

  2. Pilih tombol Selesai.

    Screenshot indicating the Complete button.

    Penting

    Harap perhatikan bahwa menyelesaikan pesan adalah penerimaan destruktif, yaitu pesan dihapus dari antrean ketika Selesai telah dipilih di alat Service Bus Explorer.

Tangguhkan pesan

  1. Di kisi, pilih pesan yang diterima yang ingin kami tangguhkan.

  2. Pilih tombol Tunda.

    Screenshot indicating the Defer button.

Abaikan kunci

  1. Di kisi, pilih pesan yang diterima yang ingin kita tinggalkan kuncinya.

  2. Pilih tombol Abaikan kunci.

    Screenshot indicating the Abandon Lock button.

Setelah kunci ditinggalkan, pesan akan tersedia untuk menerima operasi lagi.

Surat mati

  1. Di kisi, pilih pesan yang diterima yang ingin kami dead-letter.

  2. Pilih tombol Surat mati.

    Screenshot indicating the Dead-letter button.

Setelah pesan di-dead-letter, pesan akan tersedia dari sub-antrean Dead-letter .

Kirim pesan ke antrian atau topik

Untuk mengirim pesan ke antrian atau topik, pilih tombol Kirim pesan pada Service Bus Explorer.

  1. Pilih Jenis Konten menjadi Teks/Polos, Aplikasi/Xml, atau Aplikasi/Json.

  2. Untuk Isi pesan, tambahkan konten pesan. Pastikan sesuai dengan set Jenis Konten sebelumnya.

  3. Setel Properti broker (opsional) - ini termasuk ID Korelasi, ID Pesan, Balasan, Label/Subjek, Waktu Tayang (TTL) dan Waktu Antrian Terjadwal (untuk Pesan Terjadwal).

  4. Setel Properti Kustom (opsional) - ini dapat berupa properti pengguna apa pun yang disetel terhadap kunci kamus.

  5. Centang Ulangi kirim untuk mengirim pesan yang sama beberapa kali. Jika tidak ada ID Pesan yang diatur, ID pesan secara otomatis diisi dengan nilai berurutan.

  6. Setelah pesan dibuat, pilih tombol Kirim.

    Screenshot showing the compose message experience.

  7. Ketika operasi pengiriman selesai dengan sukses, salah satu hal berikut akan terjadi:

    • Jika mengirim ke antrean, penghitung metrik Pesan Aktif akan bertambah.
    • Jika mengirim ke suatu topik, penghitung metrik Pesan Aktif akan bertambah pada Langganan tempat pesan dirutekan.

Mengirim ulang pesan

Setelah mengintip atau menerima pesan, kita dapat mengirim ulang pesan, yang akan mengirim salinan pesan ke entitas yang sama, sambil memungkinkan kami memperbarui konten dan propertinya. Aslinya akan tetap ada dan tidak dihapus bahkan ketika mengirim ulang berasal dari antrean deadletter.

  1. Di kisi, pilih pesan yang ingin kami kirim ulang.

  2. Pilih tombol Kirim ulang pesan yang dipilih.

    Screenshot indicating the Resend selected messages button.

  3. Secara opsional, pilih pesan apa pun yang ingin kami perbarui detailnya dan buat perubahan yang diinginkan.

  4. Pilih tombol Kirim untuk mengirim pesan ke entitas.

    Screenshot showing the resend messages experience.

    Catatan

    • Operasi pengiriman ulang mengirimkan salinan pesan asli. Ini tidak menghapus pesan asli yang Anda kirim ulang.
    • Jika Anda mengirim ulang pesan dalam antrean surat gagal langganan, salinan pesan dikirim ke topik. Oleh karena itu, semua langganan akan menerima salinan pesan.

Ganti jenis autentikasi

Saat bekerja dengan Bus Layanan Explorer, Anda dapat menggunakan Autentikasi Kunci Akses atau ID Microsoft Entra.

  1. Pilih tombol Pengaturan.

    Screenshot indicating the Settings button in Service Bus Explorer.

  2. Pilih metode autentikasi yang diinginkan, dan pilih tombol Simpan.

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

Langkah berikutnya