Bagikan melalui

Adapter SB-Messaging

  • Artikel

Adaptor Service Bus (SB-Messaging) digunakan untuk menerima dan mengirim dari entitas Bus Layanan seperti Antrean, Topik, dan Relay. Anda dapat menggunakan adaptor SB-Messaging untuk menyambungkan BizTalk Server lokal Anda ke Azure.

Dimulai dengan BizTalk Server 2016 Feature Pack 2, Service Bus Premium didukung. Saat mengonfigurasi port kirim menggunakan adaptor ini, Anda dapat mengirim pesan ke antrean dan topik yang dipartisi.

Penting

BizTalk SB-Messaging Adapter menggunakan protokol SBMP yang mendukung pesan hingga ukuran maksimum 1mb. Adaptor BizTalk tidak mendukung protokol AMQP yang dapat menangani pesan yang lebih besar.

Mengautentikasi dengan Azure Service Bus

Azure Service Bus menyediakan dua metode untuk mengautentikasi:

  • layanan Access Control (ACS)
  • Tanda Tangan Akses Bersama (SAS)

Sebaiknya gunakan Tanda Tangan Akses Bersama (SAS) untuk mengautentikasi dengan Bus Layanan. Nilai Kunci Akses Bersama tercantum dalam portal Azure.

Saat Anda membuat namespace Service Bus, namespace layanan Access Control (ACS) tidak dibuat secara otomatis. Untuk menggunakan Access Control, Anda memerlukan nilai Nama Penerbit dan Kunci Penerbit dari namespace layanan ini. Nilai-nilai ini tersedia saat Anda membuat namespace ACS baru menggunakan Windows PowerShell. Nilai-nilai ini tidak tercantum dalam portal Azure.

Untuk menggunakan ACS untuk autentikasi, dan mendapatkan nilai Nama Penerbit dan Kunci Penerbit, langkah-langkah keseluruhan meliputi:

  1. Instal cmdlet Azure Powershell.

  2. Tambahkan akun Azure Anda: Add-AzureAccount

  3. Kembalikan nama langganan Anda: get-azuresubscription

  4. Pilih langganan Anda: select-azuresubscription <name of your subscription>

  5. Buat namespace baru: new-azuresbnamespace <name for the service bus> "Location" -CreateACSNamespace $true -NamespaceType Messaging

    Contoh: new-azuresbnamespace biztalksbnamespace "South Central US" -CreateACSNamespace $true -NamespaceType Messaging

  6. Saat namespace ACS baru dibuat (yang dapat memakan waktu beberapa menit), nilai IssuerName dan IssuerKey tercantum dalam string koneksi:

    Name                  : biztalksbnamespace
Region                : South Central US
DefaultKey            : abcdefghijklmnopqrstuvwxyz
Status                : Active
CreatedAt             : 10/18/2016 9:36:30 PM
AcsManagementEndpoint : https://biztalksbnamespace-sb.accesscontrol.windows.net/
ServiceBusEndpoint    : https://biztalksbnamespace.servicebus.windows.net/
ConnectionString      : Endpoint=sb://biztalksbnamespace.servicebus.windows.net/;SharedSecretIssuer=owner;SharedSecretValue=abcdefghijklmnopqrstuvwxyz
NamespaceType         : Messaging

Lihat New-AzureSBNamespace untuk panduan.

Menerima pesan dari Azure Service Bus

  1. Di konsol Administrasi BizTalk Server, perluas Grup BizTalk, perluas Aplikasi, lalu perluas aplikasi Anda.

  2. Klik kanan Terima Port, pilih Baru, dan pilih Port penerima satu arah.

  3. Beri nama, dan pilih Terima Lokasi.

  4. Pilih Baru, beri Nama. Di bagian Transportasi , pilih SB-Messaging dari daftar drop-down Jenis , lalu pilih Konfigurasikan.

  5. Mengonfigurasi properti Umum :

    Gunakan ini Untuk melakukan ini
    ANTREAN atau URL Langganan Tentukan URL tempat antrean Bus Layanan disebarkan. Biasanya URL dalam format berikut:

    sb://<namespace>.servicebus.windows.net/<queue_name>
    Buka Batas Waktu Menentukan nilai rentang waktu yang menunjukkan waktu untuk menyelesaikan operasi pembukaan saluran.

    Nilai default: 1 menit
    Tutup Batas Waktu Menentukan nilai rentang waktu yang menunjukkan waktu untuk menyelesaikan operasi penutupan saluran.

    Nilai default: 1 menit
    Menerima batas waktu Menentukan nilai rentang waktu yang menunjukkan waktu untuk menyelesaikan operasi penerima.

    Nilai default: 10 menit
    Jumlah prefetch Menentukan jumlah pesan yang diterima secara bersamaan dari Antrean Bus Layanan atau topik. Prefetching memungkinkan klien antrean atau langganan memuat pesan tambahan dari layanan saat melakukan operasi penerimaan. Klien menyimpan pesan ini di cache lokal. Ukuran cache ditentukan oleh nilai untuk properti Prefetch Count yang Anda tentukan di sini.

    Untuk informasi selengkapnya, lihat bagian "Prefetching" di https://azure.microsoft.com/documentation/articles/service-bus-performance-improvements/

    Nilai default: -1
    Gunakan Sesi Pilih kotak centang ini untuk menggunakan sesi Bus Layanan untuk menerima pesan dari antrean atau langganan.

  6. Konfigurasikan properti Autentikasi :

    Gunakan ini Untuk melakukan ini
    Layanan Access Control Pilih ini untuk menggunakan ACS untuk autentikasi dan berikan nilai berikut:

    - Masukkan Service Bus Access Control Service STS URI. Biasanya URI dalam format berikut:

    https://<namespace>-sb.accesscontrol.windows.net/

    - Masukkan nama pengeluar sertifikat untuk namespace Service Bus.

    - Masukkan kunci pengeluar sertifikat untuk namespace Service Bus.
    Tanda Tangan Akses Bersama (baru dimulai dengan BizTalk Server 2013 R2) Pilih ini untuk menggunakan Tanda Tangan Akses Bersama (SAS) untuk autentikasi, dan berikan nama kunci SAS dan nilai kunci.

  7. Di tab Properti , di Namespace untuk Properti Pesan Broker, masukkan namespace layanan yang digunakan adapter untuk menulis properti pesan broker sebagai properti konteks pesan pada pesan yang diterima oleh BizTalk Server. Jika Anda ingin mempromosikan properti pesan broker, pilih kotak centang Properti Pesan Broker Promosi .

  8. PilihOK.

  9. Pilih handler Terima Anda, dan alur Terima. Pilih OK untuk menyimpan perubahan Anda. Buat Lokasi Penerimaan menyediakan beberapa panduan.

Mengirim pesan ke Azure Service Bus

  1. Di konsol Administrasi BizTalk Server, klik kanan Kirim Port, pilih Baru, dan pilih Port pengiriman Satu Arah Statis.

    Buat Port Kirim menyediakan beberapa panduan.

  2. Masukkan Nama. Di Transportasi, atur Jenis ke SB-Messaging, dan pilih Konfigurasikan.

  3. Mengonfigurasi properti Umum :

    Gunakan ini Untuk melakukan ini
    URL Tujuan Masukkan URL tempat antrean Bus Layanan disebarkan. Biasanya URL dalam format berikut:

    sb://<namespace>.servicebus.windows.net/<queue_name>
    Batch Flush Interval Menentukan nilai rentang waktu yang menunjukkan interval saat batch pesan dikirim ke Antrean atau Topik dibersihkan. Nilai defaultnya adalah 20 milidetik.

    Untuk informasi selengkapnya tentang batching sehubungan dengan Antrean dan Topik Bus Layanan, lihat bagian Batching sisi klien di https://azure.microsoft.com/documentation/articles/service-bus-performance-improvements.
    Buka Batas Waktu Menentukan nilai rentang waktu yang menunjukkan waktu untuk menyelesaikan operasi pembukaan saluran.

    Nilai default: 1 menit
    Kirim Batas Waktu Menentukan nilai rentang waktu yang menunjukkan waktu untuk menyelesaikan operasi pengiriman.

    Nilai default: 1 menit
    Tutup Batas Waktu Menentukan nilai rentang waktu yang menunjukkan waktu untuk menyelesaikan operasi penutupan saluran.

    Nilai default: 1 menit

  4. Konfigurasikan properti Autentikasi :

    Gunakan ini Untuk melakukan ini
    Layanan Access Control Pilih ini untuk menggunakan ACS untuk autentikasi dan berikan nilai berikut:

    - Masukkan Service Bus Access Control Service STS URI. Biasanya URI dalam format berikut:

    https://<namespace>-sb.accesscontrol.windows.net/

    - Masukkan nama pengeluar sertifikat untuk namespace Service Bus.

    - Masukkan kunci pengeluar sertifikat untuk namespace Service Bus.
    Tanda Tangan Akses Bersama (baru dimulai dengan BizTalk Server 2013 R2) Pilih ini untuk menggunakan Tanda Tangan Akses Bersama (SAS) untuk autentikasi, dan berikan nama kunci SAS dan nilai kunci.

  5. Di tab Properti , masukkan Namespace layanan untuk Properti Pesan Broker yang ditentukan pengguna yang berisi properti konteks pesan BizTalk yang ingin Anda tulis pada pesan keluar ke Bus Layanan. Semua properti namespace ditulis ke pesan sebagai properti Pesan Broker yang ditentukan pengguna. Adaptor mengabaikan namespace saat menulis properti sebagai properti Pesan Broker. Ini hanya menggunakan namespace layanan untuk memastikan properti apa yang akan ditulis.

    Anda juga dapat memasukkan nilai untuk properti BrokeredMessage. Properti ini dijelaskan di Properti BrokeredMessage, termasuk Kunci Partisi.

  6. Pilih OK untuk menyimpan perubahan Anda.

Lihat juga

Menggunakan adaptor