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:

  • Buat Namespace Azure Service Bus.

  • Buat antrean untuk mengirim dan menerima pesan dari atau topik dengan langganan untuk menguji fungsionalitas. Untuk mempelajari cara membuat antrean, topik, dan langganan, lihat artikel berikut ini:

    Catatan

    Pastikan Anda adalah anggota dari salah satu peran ini di namespace layanan atau entitas yang ingin Anda jalankan operasi kirim atau terima (termasuk intip dan hapus menyeluruh) pada:

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.

    Cuplikan layar navigasi sisi kiri, tempat entitas dapat dipilih.

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

    Cuplikan layar halaman Antrean dengan antrean tertentu dipilih.

  3. Pilih Bus Layanan Explorer dari menu navigasi kiri

    Cuplikan layar halaman antrean tempat Bus Layanan Explorer dapat dipilih.

    Catatan

    Saat mengintip atau menerima dari langganan, pertama-tama pilih Langganan tertentu dari pemilih dropdown. Cuplikan layar dropdown untuk langganan topik.

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.

    Cuplikan layar dropdown dengan Mode Intip dipilih.

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

    Cuplikan layar tab antrean dan subantre surat mati dengan metrik pesan ditampilkan.

  3. Pilih tombol Intip dari awal.

    Cuplikan layar yang menunjukkan tombol Intip dari awal.

  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.

    Cuplikan layar dengan gambaran umum pesan yang diintip dan konten isi pesan yang ditampilkan untuk pesan yang diintip.

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

    Cuplikan layar dengan gambaran umum pesan yang diintip dan properti pesan yang ditampilkan untuk pesan yang diintip.

    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. Cuplikan layar dengan gambaran umum pesan dan tombol yang diintip untuk memuat isi pesan yang ditampilkan.

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.

    Cuplikan layar dropdown dengan Mode Intip dipilih untuk mengintip dengan opsi tingkat lanjut.

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

    Cuplikan layar tab antrean dan sub-antrean surat mati dengan metrik pesan ditampilkan untuk mengintip dengan opsi tingkat lanjut.

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

    Cuplikan layar yang menunjukkan tombol Intip dengan opsi, dan halaman tempat opsi dapat diatur.

  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.

    Cuplikan layar dengan gambaran umum pesan yang diintip dan konten isi pesan yang ditampilkan untuk mengintip dengan opsi tingkat lanjut.

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

    Cuplikan layar dengan gambaran umum pesan yang diintip dan properti pesan yang ditampilkan untuk mengintip dengan opsi tingkat lanjut.

    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.

    Cuplikan layar dropdown dengan Mode Terima dipilih.

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

    Cuplikan layar tab antrean dan sub-antrean surat mati dengan metrik pesan ditampilkan untuk mode terima.

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

    Cuplikan layar yang menunjukkan tombol Terima, dan halaman tempat opsi dapat diatur.

    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.

    Cuplikan layar dengan gambaran umum pesan yang diterima dan konten isi pesan ditampilkan.

    Cuplikan layar dengan gambaran umum pesan yang diterima dan properti pesan ditampilkan.

    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.

    Cuplikan layar yang menunjukkan tombol Selesai.

    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.

    Cuplikan layar yang menunjukkan tombol Tunda.

Abaikan kunci

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

  2. Pilih tombol Abaikan kunci.

    Cuplikan layar yang menunjukkan tombol Abaikan Kunci.

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.

    Cuplikan layar yang menunjukkan tombol Surat mati.

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

Hapus menyeluruh pesan

Untuk Menghapus menyeluruh pesan, pilih tombol Hapus menyeluruh pesan penjelajah Bus Layanan.

Cuplikan layar yang menunjukkan tombol hapus menyeluruh pesan.

Setelah Anda memasukkan 'hapus menyeluruh' untuk mengonfirmasi operasi, pesan akan dihapus menyeluruh dari entitas bus layanan masing-masing.

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.

    Cuplikan layar memperlihatkan pengalaman membuat pesan.

  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.

    Cuplikan layar yang menunjukkan tombol Kirim ulang pesan yang dipilih.

  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.

    Cuplikan layar memperlihatkan pengalaman mengirim ulang pesan.

    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.

    Cuplikan layar yang menunjukkan tombol Pengaturan di Bus Layanan Explorer.

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

    Cuplikan layar yang menunjukkan tombol Pengaturan dan halaman yang memperlihatkan berbagai jenis autentikasi.

Langkah berikutnya