Baca dalam bahasa Inggris

Bagikan melalui


Adaptor penyimpanan Azure Blob di BizTalk Server

Dimulai dengan BizTalk Server 2020 dan yang lebih baru, Anda dapat mengirim dan menerima pesan antara BizTalk Server dan penyimpanan Azure Blob.

Penyimpanan Azure Blob adalah solusi penyimpanan objek Microsoft untuk cloud, yang dioptimalkan untuk menyimpan sejumlah besar data yang tidak terstruktur. Untuk informasi selengkapnya, lihat Apa itu penyimpanan Azure Blob?.

Prasyarat

Buat akun penyimpanan blob Azure dengan kontainer.

Mengirim pesan ke penyimpanan Azure Blob

  1. Di konsol Administrasi BizTalk Server, klik kanan Kirim Port> PengirimanStatis Satu ArahBaru> port.

    Buat Port Kirim menyediakan beberapa panduan.

  2. Masukkan Nama. Di Transportasi, atur Jenis ke AzureBlobStorage, dan pilih Konfigurasikan.

  3. Mengonfigurasi properti Akun Azure .

    Tip

    Jendela konfigurasi adaptor dapat mengisi sumber daya Azure Anda secara otomatis setelah masuk ke langganan Azure Anda. Ini membuat konfigurasi lebih mudah. Masuk ke langganan Azure bersifat optinal.

    • Masuk: Masuk ke akun Azure Anda.
    • Langganan: Pilih langganan yang memiliki akun penyimpanan Azure Anda.
    • Grup sumber daya: Pilih grup sumber daya yang memiliki akun penyimpanan Azure Anda.
  4. Mengonfigurasi properti Umum :

    • Autentikasi Penyimpanan: Pilih metode autentikasi:

      • Tanda tangan akses bersama dipilih secara default. Anda harus memasukkan string koneksi Tanda Tangan Akses Bersama di bidang String koneksi.
      • Jika Anda menggunakan Kunci akses, kumpulan akun penyimpanan diisi di daftar drop-down Akun . Setelah Anda memilih akun penyimpanan, bidang String koneksi secara otomatis diisi dengan kunci akses utama, juga dikenal sebagai key1.

      Tautan berikut adalah sumber daya yang baik untuk membantu Anda memutuskan metode autentikasi mana yang tepat untuk skenario Anda:

    • Nama kontainer blob: Pilih nama kontainer Blob Anda dari daftar drop-down. Daftar diisi secara otomatis setelah string Koneksi dimasukkan.

    • Nama blob: Masukkan nama blob yang akan digunakan oleh adaptor. Makro dapat digunakan dalam nama blob. Untuk makro yang tersedia, lihat Menggunakan makro dalam nama file.

    • Namespace untuk metadata blob: Masukkan namespace sebagai filter. Properti konteks pesan ditulis ke metadata blob jika namespace properti cocok dengan bidang ini.

    Setelah selesai, properti Anda terlihat mirip dengan yang berikut ini:

    Penyimpanan blob Azure mengirim properti Umum adaptor di BizTalk Server

  5. Konfigurasikan properti Tingkat Lanjut :

    • Jenis blob: Masukkan jenis Blob yang akan digunakan. Untuk informasi selengkapnya, lihat jenis blob.
    • Mode tulis: Gunakan pengaturan ini untuk menentukan perilaku adaptor ketika nama Blob yang diberikan sudah ada.
      • Buat baru: Adaptor selalu mencoba membuat blob baru. Jika blob dengan nama yang sama sudah ada, pesan BizTalk akan ditangguhkan.
      • Timpa: Adaptor menimpa jika nama blob sudah ada. Metadata juga ditimpa.
      • Tambahkan: Adaptor menambahkan isi pesan ke blob yang ada jika blob sudah ada. Metadata tidak berubah.
  6. Pilih OK untuk menyimpan perubahan Anda.

Menguji port pengiriman Anda

Anda dapat menggunakan port dan lokasi penerima File sederhana untuk mengirim pesan ke penyimpanan Azure Blob Anda.

  1. Menggunakan adaptor File, buat port terima bernama FileReceivePort. Dalam lokasi penerimaan Anda, atur folder Terima ke C:\Temp\In\\, dan atur masker file ke \*.xml.

  2. Di penyimpanan Azure Blob Anda mengirim properti port, atur Filter ke BTS.ReceivePortName == FileReceivePort.

  3. Tempelkan yang berikut ini ke editor teks, dan simpan file sebagai AzureBlobStorageMessage.xml. File ini adalah contoh pesan Anda.

    <Data>
      <DataID>DataID_0</DataID>
      <DataDetails>DataDetails_0</DataDetails>
    </Data>
    
  4. Mulai lokasi penerimaan File dan port pengiriman penyimpanan blob Azure.

  5. Salin pesan sampel AzureBlobStorageMessage.xml ke folder terima, seperti C:\Temp\In\. Port kirim mengirimkan file XML ke penyimpanan blob Azure. Konfirmasikan dengan melihat ke dalam kontainer penyimpanan Azure Anda, dan menampilkan file yang baru dibuat atau diperbarui.

Menerima pesan dari penyimpanan Azure Blob

  1. Di konsol Administrasi BizTalk Server, klik kanan Terima Port Penerimaan>Satu ArahBaru> port.

    Membuat port penerima memberikan beberapa panduan.

  2. Masukkan nama, dan pilih Terima Lokasi.

  3. Pilih Baru, dan Beri nama lokasi terima. Di Transportasi, pilih AzureBlobStorage dari daftar drop-down Jenis . Pilih Konfigurasikan.

  4. Mengonfigurasi properti Akun Azure :

    Tip

    Similiar ke adaptor kirim, ini opsional.

    • Masuk: Masuk ke akun Azure Anda.
    • Langganan: Pilih langganan yang memiliki akun penyimpanan Azure Anda.
    • Grup Sumber Daya: Pilih grup sumber daya yang memiliki akun penyimpanan Azure Anda.
  5. Mengonfigurasi properti Umum :

    • Autentikasi Penyimpanan: Pilih metode autentikasi:

      • Tanda tangan akses bersama dipilih secara default. Anda harus memasukkan string koneksi Tanda Tangan Akses Bersama di bidang String koneksi.
      • Jika Anda menggunakan Kunci akses, kumpulan akun penyimpanan diisi di daftar drop-down Akun . Setelah Anda memilih akun penyimpanan, bidang String koneksi secara otomatis diisi dengan kunci akses utama, juga dikenal sebagai key1.

      Tautan berikut adalah sumber daya yang baik untuk membantu Anda memutuskan mana yang tepat untuk skenario Anda:

    • Nama kontainer blob: Pilih nama kontainer blob Anda dari daftar drop-down. Daftar diisi secara otomatis setelah string Koneksi dimasukkan.

    • Awalan nama blob: Masukkan awalan jika berlaku. Misalnya, jika "order/" digunakan untuk awalan nama Blob, maka lokasi penerima hanya mengambil file di folder "order".

    • Namespace untuk metadata blob: Masukkan namespace untuk adaptor untuk membuat properti konteks dari metadata blob kustom.

    • Mempromosikan properti metadata: Pilih apakah metadata blob kustom dipromosikan atau tidak.

    Catatan

    Secara default, semua properti blob standar, seperti Blob Uri, Name, dan BlobType, diatur sebagai properti konteks pesan BizTalk dengan http://schemas.microsoft.com/BizTalk/Adapter/AzureStorage-properties namespace.

    Setelah selesai, properti Anda terlihat mirip dengan yang berikut ini:

    Penyimpanan blob Azure menerima properti Umum adaptor di BizTalk Server

  6. Konfigurasikan properti Tingkat Lanjut :

    • Interval polling: Masukkan interval polling.
    • Pesan maksimum per batch: Masukkan jumlah pesan batch adaptor saat mengirimkan ke BizTalk.
    • Unduhan paralel: Masukkan jumlah maksimum blob yang diizinkan untuk diunduh secara paralel.
    • Ambang kesalahan: Masukkan ambang kesalahan. Ketika lokasi terima mencapai jumlah kesalahan ini, lokasi terima dinonaktifkan.
  7. Pilih OK untuk menyimpan perubahan Anda.

Menguji pengaturan penerimaan Anda

Anda dapat menggunakan port pengiriman File sederhana untuk menerima pesan dari penyimpanan Azure Blob Anda.

  1. Buat port kirim menggunakan adaptor File. Dalam properti port pengiriman Anda, atur folder Tujuan ke C:\Temp\Out\\, dan atur dan Nama file ke %MessageID%.xml.
  2. Di properti port pengiriman file Anda, atur Filter ke BTS.ReceivePortName == BlobReceivePort.
  3. Buat port penerima bernama BlobReceivePort, dan buat lokasi penerimaan penyimpanan Azure Blob. Mulailah.
  4. Unggah file ke kontainer blob di portal Azure. Perhatikan awalan pencocokan yang Anda konfigurasikan di adaptor. Cari pesan di folder tujuan (c:\temp\out).

Penting

Adaptor penerima penyimpanan Azure Blob menghapus blob setelah dikirimkan ke database BizTalk MessageBox.

Ketersediaan Tinggi adaptor penyimpanan Azure Blob

Adaptor penerima penyimpanan Azure Blob mendukung ketersediaan tinggi. Anda dapat menambahkan beberapa instans host di adaptor penyimpanan Azure Blob yang sama menerima handler untuk menerima dari kontainer blob yang sama secara bersamaan. Penyewaan blob digunakan sebagai kunci untuk menghindari blob yang sama diterima oleh beberapa instans host. Sesuai:

  • Blob yang disewa oleh proses lain tidak akan diterima oleh adaptor penyimpanan Azure Blob.
  • Blob yang diterima oleh adaptor penyimpanan Azure Blob tidak dapat diperbarui saat dalam status sewaan.

Untuk informasi selengkapnya tentang penyewaan blob Azure, lihat konkurensi pesimis untuk blob.

Adaptor pengiriman penyimpanan Azure Blob, seperti kebanyakan adaptor pengiriman, menyediakan ketersediaan tinggi untuk host pengirim dengan memiliki beberapa instans host di host pengiriman yang sama.

Langkah berikutnya

Adapter di BizTalk Server