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 群組成員的帳戶登入。
在 [BizTalk Server 管理] 中,依序展開 [BizTalk 群組]、[應用程式],然後選取您的應用程式。
以滑鼠右鍵按兩下 [ 傳送埠],選取 [ 新增],然後選取 [ 靜態單向傳送埠]。
在 [ 傳送埠屬性] 中,將 [傳輸類型 ] 設定為 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。 選取 [ 確定 ] 以儲存變更。
針對 傳送處理程式,選取要執行配接器的主機實例,然後選取 [傳送管線]。
選取 [ 確定 ] 以儲存變更。
在 [ 傳送埠] 中,以滑鼠右鍵按兩下新的傳送埠,然後選取 [ 登記 ],然後選取 [ 啟動]。
建立 DB2 接收埠
使用 BizTalk Server Administrators 群組成員的帳戶登入。
在 [BizTalk Server 管理] 中,依序展開 [BizTalk 群組]、[應用程式],然後選取您的應用程式。
以滑鼠右鍵按兩下 [接收埠],選取 [ 新增],然後選取 [單向接收埠]。 設定您的屬性,然後選取 [ 確定]。
以滑鼠右鍵按兩下 [接收位置],選取 [ 新增],然後選取 [單向接收位置]。 選取您剛才建立的接收埠,然後按兩下 [ 確定]。
在 [ 接收位置屬性] 中,將 [傳輸類型 ] 設定為 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。 輪詢的度量單位 輪詢要求之間使用的測量單位 (秒、分鐘或小時) 。 預設值為秒。 選取 [ 確定 ] 以儲存變更。
針對 [接收處理程式],選取要執行配接器的主機實例。 接收處理常式必須在此主控件上執行。 選取 [接收管線]。 . 選取 [ 確定 ] 以儲存變更。
在 [接收位置] 中,以滑鼠右鍵按下接收位置,然後按兩下 [ 啟用]。
建立 DB2 配接器架構
開啟 BizTalk Visual Studio 專案。
以滑鼠右鍵按兩下項目,選取 [ 新增],選取 [ 新增產生的專案],然後選取 [ 新增]。
在 [ 新增產生的專案] 對話框中,選取 [ 新增配接器元數據]。
在 [新增配接器精靈] 的 [ 選取 配接器] 頁面上,選取 [DB2]。 在 [埠] 清單中,選取已設定的傳送埠或接收位置,然後選取 [ 下一步]。
在 [DB2 配接器架構產生精靈] 中:
在 [資料庫資訊] 中,建立 連接字串,或選取現有的 連接字串。
在 [架構資訊] 中,定義要用於架構的預設命名空間、根元素和埠類型。
如果您選取 [接收埠],只需要要求檔根元素名稱。 如果您選取 [傳送埠],則需要要求和回應檔根元素名稱。
在 [語句類型資訊] 中,選取要發出的資料庫命令類型。
如果您在上一頁選取了接收埠,您可以選擇 SELECT SQL 語句或預存程式。 如果您在上一頁選取了傳送埠,您可以選擇發出 updategram、預存程式或 SELECT 語句。
在 [語句資訊] 中,輸入 DB2 資料庫的詳細數據。 根據您先前輸入的資訊,可以使用下列屬性:
在 [語句資訊] 對話框中接收 Select 語句,在 [SQL 腳本] 編輯方塊中輸入 SQL SELECT 語句。 或者,按兩下 [ 瀏覽] 以載入包含語句的文字檔。
在 [語句資訊] 對話框中接收預存程式,按下預存程式名稱。 在 [參數] 列表中,按兩下每個必要參數的 [值 ] 複選框。
在 [語句資訊] 對話框中傳送 Updategram,按兩下 [數據表名稱]。 在 [ 參數 ] 列表中,按兩下每個必要資料行的 [ 值 ] 複選框。 使用 BulkCopy 時,您必須按兩下 [每個 值 ] 複選框,以選取所有數據行。
在 [語句資訊] 對話框中傳送預存程式,按兩下預存程式名稱。 在 [ 參數] 列表中,按兩下每個必要參數的 [值 ] 複選框。
在 [語句資訊] 對話框中傳送 Select 語句,在 [SQL 腳本] 編輯方塊中輸入 SQL SELECT 語句。 或者,按兩下 [ 瀏覽] 以載入包含語句的文字檔。
選取 [完成] 以完成精靈。
您現在有架構。