BizTalk Adapter for DB2 設定 - HIS

概觀

Microsoft BizTalk Adapter for DB2 會將 BizTalk Server 連接到儲存在 IBM 大型主機 DB2 for z/OS、IBM midrange DB2 for IBM i 和 IBM server DB2 上執行的重要數據,以及 LINUX、UNIX 和 Windows 操作系統上執行的 IBM Server DB2。 配接器是以 Microsoft ADO.NET Data Provider for DB2 為基礎,並支援廣泛的功能,包括跨 SNA 和 TCP/IP 網路連線的分散式交易傳送埠和接收埠。 使用埠設定精靈內定義的 SQL 命令,IT 專業人員可以輕鬆地建立可有效率地整合 DB2 資料庫的解決方案,而不需要撰寫程式代碼。

配接器提供兩個主要功能:

  • 針對 [傳送 作業] (One Way 和 Solicit Response) ,配接器會將 SQL 命令和預存程式傳送至 DB2 實例,並提供要求回應的選項。

  • 針對 [接收 作業] (僅) ,配接器會建立 SQL 命令或預存程式來輪詢 DB2 物件並建立個別數據列訊息,然後提交至 BizTalk 訊息系統。

    此外,BizTalk Adapter for DB2 使用標準的 BizTalk 配接器追蹤工具作為疑難解答機制。

建立 DB2 傳送埠

使用 BizTalk Server Administrators 群組成員的帳戶登入。

  1. [BizTalk Server 管理] 中,依序展開 [BizTalk 群組]、[應用程式],然後選取您的應用程式。

  2. 以滑鼠右鍵按兩下 [ 傳送埠],選取 [ 新增],然後選取 [ 靜態單向傳送埠]。

  3. 在 [ 傳送埠屬性] 中,將 [傳輸類型 ] 設定為 DB2。 選擇 [ 設定],然後輸入下列屬性:

    使用 作法
    BulkCopyBatchSize BulkCopyBatchSize 屬性會指示配接器處理每個批次交易的數據列數目。 這個 選擇性 屬性接受 整數 值。 預設值為 20。 值為 0 會指示配接器處理單一批次中的所有數據列。
    CommandTimeout CommandTimeout 屬性會設定 Adapter 終止執行命令的等候時間,然後產生錯誤。 這個 選擇性 屬性接受 整數 值。 預設值為 30 秒。 值為 0 表示 (嘗試執行命令時不會無限期等候) 。
    連接字串 用來連接到 DB2 資料庫的 連接字串 名稱。

    若要設定新的或現有的連接字串,請按下省略號 (...) 。 這會啟動 [數據源精靈]。

    若要存取說明,請按兩下精靈頁面上的 [ 說明 ],或開啟 [主機整合伺服器說明],然後查看 [ 數據源精靈] (DB2)
    DB2 集緩存器 DB2 Set Registers 屬性會指示配接器執行一或多個 SQL SET 語句。 這個選擇性屬性接受 字串 值。 默認值是 空字串,表示沒有語句。 支援的語法是以逗號分隔的 SET 語句命令清單,並以逗號分隔的 SET 語句值清單“<SET 命令 1 空格 <SET 值 1>> 分號; <SET 命令 2> 空格 <SET 值以>逗號 <SET 值 b> 分號“) 。 例如,輸入 「SET CURRENT PATH」DSN8910', 'HISDEMO'“。
    文件目標命名空間 傳送至 DB2 之 XML 檔中使用的目標命名空間。
    回應根項目名稱 從 DB2 接收之 XML 檔中使用的根元素名稱。 (這個屬性可能是單向埠的空白。)
    URI 統一資源標識碼。 用來識別傳送埠位置的名稱。 預設值為 DB2://。
    UseBulkCopy UseBulkCopy 屬性會指示配接器處理大量複製模式中的傳送埠 INSERT 命令,以改善效能。 這個 選擇性 屬性接受 布爾 值。 預設值為 false
  4. 選取 [ 確定 ] 以儲存變更。

  5. 針對 傳送處理程式,選取要執行配接器的主機實例,然後選取 [傳送管線]。

  6. 選取 [ 確定 ] 以儲存變更。

  7. 在 [ 傳送埠] 中,以滑鼠右鍵按兩下新的傳送埠,然後選取 [ 登記 ],然後選取 [ 啟動]。

建立 DB2 接收埠

使用 BizTalk Server Administrators 群組成員的帳戶登入。

  1. [BizTalk Server 管理] 中,依序展開 [BizTalk 群組]、[應用程式],然後選取您的應用程式。

  2. 以滑鼠右鍵按兩下 [接收埠],選取 [ 新增],然後選取 [單向接收埠]。 設定您的屬性,然後選取 [ 確定]。

  3. 以滑鼠右鍵按兩下 [接收位置],選取 [ 新增],然後選取 [單向接收位置]。 選取您剛才建立的接收埠,然後按兩下 [ 確定]。

  4. 在 [ 接收位置屬性] 中,將 [傳輸類型 ] 設定為 DB2。 選擇 [ 設定],然後輸入下列屬性:

    使用 作法
    CommandTimeout CommandTimeout 屬性會設定 Adapter 終止執行命令的等候時間,然後產生錯誤。 這個選擇性屬性接受整數值。 預設值為 30 秒。 值為 0 表示 (嘗試執行命令時不會無限期等候) 。
    連接字串 輸入將用來連接到 DB2 資料庫的 連接字串 名稱。

    若要設定新的或現有的連接字串,請按下省略號 (...) 。 這會啟動 [數據源精靈]。 若要存取說明,請按兩下精靈頁面上的 [ 說明 ],或開啟 [主機整合伺服器說明],然後查看 [ 數據源精靈] (DB2)
    DB2 集緩存器 DB2 Set Registers 屬性會指示配接器執行一或多個 SQL SET 語句。 這個選擇性屬性接受字串值。 默認值是空字串,表示沒有語句。 支援的語法是以逗號分隔的 SET 語句命令清單,並以逗號分隔的 SET 語句值清單“<SET 命令 1 空格 <SET 值 1>> 分號; <SET 命令 2> 空格 <SET 值以>逗號 <SET 值 b> 分號“) 。 例如,輸入 「SET CURRENT PATH」DSN8910', 'HISDEMO'“。
    文件根項目名稱 從 DB2 接收之 XML 檔中使用的根元素名稱。
    文件目標命名空間 從 DB2 接收之 XML 檔中所使用的目標命名空間。
    SQL 命令 針對每個輪詢間隔執行一次的 select 或預存程式命令。
    更新命令 處理接收作業中每個數據列之後執行的命令。 它可以是刪除語句,從 SQL 命令中的數據表刪除數據列,或是靜態修改一或多個數據列的更新命令。 指定此選項時,SQL 命令必須是 Select 語句,而且必須存取單一數據表。
    URI 識別接收埠位置的名稱。 預設值為 DB2://。
    輪詢間隔 輪詢要求之間的單位數目。 允許的範圍是 1 - 65535。
    輪詢的度量單位 輪詢要求之間使用的測量單位 (秒、分鐘或小時) 。 預設值為秒。
  5. 選取 [ 確定 ] 以儲存變更。

  6. 針對 [接收處理程式],選取要執行配接器的主機實例。 接收處理常式必須在此主控件上執行。 選取 [接收管線]。 . 選取 [ 確定 ] 以儲存變更。

  7. [接收位置] 中,以滑鼠右鍵按下接收位置,然後按兩下 [ 啟用]。

建立 DB2 配接器架構

  1. 開啟 BizTalk Visual Studio 專案。

  2. 以滑鼠右鍵按兩下項目,選取 [ 新增],選取 [ 新增產生的專案],然後選取 [ 新增]。

  3. 在 [ 新增產生的專案] 對話框中,選取 [ 新增配接器元數據]。

  4. 在 [新增配接器精靈] 的 [ 選取 配接器] 頁面上,選取 [DB2]。 在 [埠] 清單中,選取已設定的傳送埠或接收位置,然後選取 [ 下一步]。

  5. 在 [DB2 配接器架構產生精靈] 中:

    1. [資料庫資訊] 中,建立 連接字串,或選取現有的 連接字串。

    2. [架構資訊] 中,定義要用於架構的預設命名空間、根元素和埠類型。

      如果您選取 [接收埠],只需要要求檔根元素名稱。 如果您選取 [傳送埠],則需要要求和回應檔根元素名稱。

    3. [語句類型資訊] 中,選取要發出的資料庫命令類型。

      如果您在上一頁選取了接收埠,您可以選擇 SELECT SQL 語句或預存程式。 如果您在上一頁選取了傳送埠,您可以選擇發出 updategram、預存程式或 SELECT 語句。

    4. [語句資訊] 中,輸入 DB2 資料庫的詳細數據。 根據您先前輸入的資訊,可以使用下列屬性:

      1. 在 [語句資訊] 對話框中接收 Select 語句,在 [SQL 腳本] 編輯方塊中輸入 SQL SELECT 語句。 或者,按兩下 [ 瀏覽] 以載入包含語句的文字檔。

      2. 在 [語句資訊] 對話框中接收預存程式,按下預存程式名稱。 在 [參數] 列表中,按兩下每個必要參數的 [值 ] 複選框。

      3. 在 [語句資訊] 對話框中傳送 Updategram,按兩下 [數據表名稱]。 在 [ 參數 ] 列表中,按兩下每個必要資料行的 [ ] 複選框。 使用 BulkCopy 時,您必須按兩下 [每個 ] 複選框,以選取所有數據行。

      4. 在 [語句資訊] 對話框中傳送預存程式,按兩下預存程式名稱。 在 [ 參數] 列表中,按兩下每個必要參數的 [值 ] 複選框。

      5. 在 [語句資訊] 對話框中傳送 Select 語句,在 [SQL 腳本] 編輯方塊中輸入 SQL SELECT 語句。 或者,按兩下 [ 瀏覽] 以載入包含語句的文字檔。

  6. 選取 [完成] 以完成精靈。

您現在有架構。