BizTalk Server中的 Azure Blob 儲存體配接器

發行項
05/04/2023

從 BizTalk Server 2020 和更新版本開始，您可以在BizTalk Server與 Azure Blob 儲存體之間傳送和接收訊息。

Azure Blob 儲存體是 Microsoft 的雲端物件儲存體解決方案，其已針對儲存大量非結構化資料進行優化。如需詳細資訊，請參閱什麼是 Azure Blob 儲存體？。

必要條件

使用容器建立 Azure Blob 儲存體帳戶。

將訊息傳送至 Azure Blob 儲存體

在 BizTalk Server 管理主控台中，以滑鼠右鍵按一下 [傳送埠>] [新增>靜態單向傳送埠]。

建立傳送埠提供一些指引。
輸入 [名稱] 。在 [傳輸] 中，將 [類型 ] 設定為 [AzureBlobStorage]，然後選取 [ 設定]。
設定 Azure 帳戶 屬性。

提示

配接器組態視窗可以在登入 Azure 訂用帳戶之後自動填入您的 Azure 資源。這可讓設定更容易。登入 Azure 訂用帳戶是選擇的。
- 登入：登入您的 Azure 帳戶。
- 訂用帳戶：選取具有 Azure 儲存體帳戶的訂用帳戶。
- 資源群組：選取具有 Azure 儲存體帳戶的資源群組。
設定 [一般 ] 屬性：
- 儲存體驗證：選取驗證方法：
  - 預設會選取共用存取簽章。您必須在 [連接字串] 欄位中輸入共用存取簽章連接字串。
  - 如果您使用 存取金鑰，則會在 [ 帳戶 ] 下拉式清單中填入儲存體帳戶的集合。選取儲存體帳戶之後， [連接字串 ] 欄位會自動填入主要存取金鑰，也稱為 key1。
  下列連結是良好的資源，可協助您決定哪一種驗證方法適合您的案例：
  - 授權存取 Azure 儲存體中的資料
  - 使用共用存取簽章 (SAS)
- Blob 容器名稱：從下拉式清單中選取 Blob 容器的名稱。輸入 連接字串 之後，就會自動填入清單。
- Blob 名稱：輸入配接器要使用的 Blob 名稱。宏可用於 Blob 名稱。如需可用的宏，請參閱在檔案名中使用宏。
- Blob 中繼資料的命名空間：輸入命名空間作為篩選準則。如果屬性的命名空間符合此欄位，訊息的內容屬性就會寫入 Blob 中繼資料。
完成後，您的屬性看起來會類似下列內容：
設定進階屬性：
- Blob 類型：輸入要使用的 Blob 類型 。如需詳細資訊，請參閱 Blob 類型。
- 寫入模式：當指定的 Blob 名稱 已經存在時，請使用此設定來指定配接器行為。
  - 新建：配接器一律會嘗試建立新的 Blob。如果已有相同名稱的 Blob，BizTalk 訊息就會暫停。
  - 覆寫：如果 Blob 名稱已經存在，配接器就會覆寫。也會覆寫中繼資料。
  - 附加：如果 Blob 已經存在，配接器會將訊息本文附加至現有的 Blob。中繼資料不會變更。
選取 [ 確定 ] 以儲存變更。

測試傳送埠

您可以使用簡單的檔案接收埠和位置，將訊息傳送至 Azure Blob 儲存體。

使用檔案配接器，建立名為 FileReceivePort的接收埠。在您的接收位置內，將 [接收] 資料夾 設定為 C:\Temp\In\\ ，並將檔案遮罩設定為 \*.xml 。
在 Azure Blob 儲存體傳送埠屬性中，將 [篩選 ] 設定為 BTS.ReceivePortName == FileReceivePort 。
將下列內容貼到文字編輯器中，並將檔案儲存為 AzureBlobStorageMessage.xml。此檔案是您範例訊息。
```
<Data>
  <DataID>DataID_0</DataID>
  <DataDetails>DataDetails_0</DataDetails>
</Data>
```
啟動檔案接收位置和 Azure Blob 儲存體傳送埠。
將 AzureBlobStorageMessage.xml 範例訊息複製到接收資料夾中，例如 C:\Temp\In\ 。傳送埠會將 XML 檔案傳送至 Azure Blob 儲存體。查看您的 Azure 儲存體容器，並檢視新建立或更新的檔案來確認。

從 Azure Blob 儲存體接收訊息

在 BizTalk Server 管理主控台中，以滑鼠右鍵按一下[接收埠>] [新增>單向接收埠]。

建立接收埠提供一些指引。
輸入名稱，然後選取 [接收位置]。
選取 [新增]，然後命名接收位置。在[傳輸] 中，從 [類型] 下拉式清單中選取[AzureBlobStorage]。選取 [設定]
設定 Azure 帳戶 屬性：

提示

對傳送配接器進行簡化，這是選擇性的。
- 登入：登入您的 Azure 帳戶。
- 訂用帳戶：選取具有 Azure 儲存體帳戶的訂用帳戶。
- 資源群組：選取具有 Azure 儲存體帳戶的資源群組。
設定 [一般 ] 屬性：
- 儲存體驗證：選取驗證方法：
  - 預設會選取共用存取簽章。您必須在 [連接字串] 欄位中輸入共用存取簽章連接字串。
  - 如果您使用 存取金鑰，則會在 [ 帳戶 ] 下拉式清單中填入儲存體帳戶的集合。選取儲存體帳戶之後， [連接字串 ] 欄位會自動填入主要存取金鑰，也稱為 key1。
  下列連結是良好的資源，可協助您決定適合您的案例：
  - 授權存取 Azure 儲存體中的資料
  - 使用共用存取簽章 (SAS)
- Blob 容器名稱：從下拉式清單中選取 Blob 容器的名稱。輸入 連接字串 之後，就會自動填入清單。
- Blob 名稱前置詞：輸入適用位置的前置詞。例如，如果「order/」用於 Blob 名稱前置詞，則接收位置只會挑選「order」資料夾中的檔案。
- Blob 中繼資料的命名空間：輸入介面卡的命名空間，以從自訂 Blob 中繼資料建立內容屬性。
- 升級中繼資料屬性：選擇是否升級自訂 Blob 中繼資料。
注意

根據預設，所有標準 Blob 屬性，例如 Blob Uri、名稱和 BlobType，都會設定為具有命名空間之 BizTalk 訊息 http://schemas.microsoft.com/BizTalk/Adapter/AzureStorage-properties 的內容屬性。

完成後，您的屬性看起來會類似下列內容：
設定進階屬性：
- 輪詢間隔：輸入輪詢間隔。
- 每個批次的訊息數目上限：輸入提交至 BizTalk 時配接器批次的訊息數目。
- 平行下載：輸入允許平行下載的 Blob 數目上限。
- 錯誤臨界值：輸入錯誤臨界值。當接收位置達到這個錯誤數目時，就會停用接收位置。
選取 [ 確定 ] 以儲存變更。

測試您的接收設定

您可以使用簡單的檔案傳送埠，從 Azure Blob 儲存體接收訊息。

使用檔案配接器建立傳送埠。在傳送埠屬性中，將 [目的地] 資料夾 設定為 C:\Temp\Out\\ ，並將和 [檔案名 ] 設定為 %MessageID%.xml 。
在 [檔案傳送埠屬性] 中，將 [篩選 ] 設定為 BTS.ReceivePortName == BlobReceivePort 。
建立名為 BlobReceivePort的接收埠，並建立 Azure Blob 儲存體接收位置。啟動它。
將檔案上傳至 Azure 入口網站中的 Blob 容器。請注意您在配接器中設定的相符前置詞。尋找目的地資料夾中的訊息， (c：\temp\out) 。

重要

Azure Blob 儲存體接收配接器會在 Blob 提交至 BizTalk MessageBox 資料庫之後刪除該 Blob。

Azure Blob 儲存體配接器的高可用性

Azure Blob 儲存體接收配接器支援高可用性。您可以在相同的 Azure Blob 儲存體配接器接收處理常式中新增多個主機實例，以同時從相同的 Blob 容器接收。 Blob 租用是用來作為鎖定，以避免多個主機實例收到相同的 Blob。因此：

Azure Blob 儲存體配接器不會收到其他進程租用的 Blob。
Azure Blob 儲存體配接器所接收的 Blob 在處於租用狀態時無法更新。

如需 Azure Blob 租用的詳細資訊，請參閱 Blob 的封閉式並行存取。

Azure Blob 儲存體傳送配接器就像大部分的傳送配接器一樣，藉由在同一個傳送主機中擁有多個主機實例，為傳送主機提供高可用性。

下一步

BizTalk Server 中的配接器

共用方式為