適用於:Azure Logic Apps (使用量 + 標準)
當你的自動化整合工作流程需要處理 DB2 資料庫中的資源時,請使用 DB2 連接器來執行資料庫操作。 例如,你的工作流程可以列出資料表或列、新增資料列、更新資料列、刪除資料列、執行查詢,以及執行儲存程序。 這些動作可以從資料庫回傳資料,供工作流程中使用其他動作。
Azure Logic Apps 提供以下 DB2 連接器版本:
- 受控連接器:適用於使用及標準工作流程。 對於本地的 DB2 伺服器,此連接器需要本地資料閘道器。
- 內建連接器:僅適用於標準工作流程。 此連接器可與 Azure Logic Apps 執行時同步執行,並直接透過 TCP/IP 連接 DB2,無需本地資料閘道。
兩個版本皆可透過 TCP/IP 網路與遠端 DB2 伺服器通訊。 你可以使用任一版本來存取雲端資料庫,例如在 Azure 虛擬化中運行的 IBM DB2 for Windows。
Important
對於使用標準工作流程的關鍵任務系統,請使用內建連接器。 內建連接器避免了額外的閘道依賴,並帶來與 Azure Logic Apps 執行時在過程中運行的效能與吞吐量優勢。 當你需要特定操作或使用消耗型工作流程時,請使用管理連接器。
本指南說明兩種接頭版本的操作與連接設定。
支援的平台和版本
DB2 連接器支援以下 IBM DB2 平台與版本,以及支援分散式關聯式資料庫架構(DRDA)SQL 存取管理器(SQLAM)版本 10 與 11 的 IBM DB2 相容產品:
| 平台 | 版本 |
|---|---|
| 適用於 z/OS 的 IBM DB2 | 12、11.1、10.1 |
| 適用於 i 的 IBM DB2 | 7.4, 7.3, 7.2, 7.1 |
| 適用於 LUW 的 IBM DB2 | 11.5, 11.1, 10.5 |
連接器技術參考
DB2 連接器有不同版本,依據 邏輯應用程式類型與主機環境而定。
| 邏輯應用程式 | 環境 | 連線版本 |
|---|---|---|
| 消費 | 多租用戶 Azure Logic Apps | 受控連接器 (顯示於 [共用] 篩選下的連接器資源庫中)。 此連接器僅提供動作,不提供觸發程序。 對於本地的 DB2 伺服器,管理連接器需要本地的資料閘道器。 如需詳細資訊,請參閱下列文件: - DB2 管理連接器參考 - Azure Logic Apps 的受控連接器 |
| Standard | 工作流程服務方案、App Service 環境 v3(僅限 Windows 方案的 ASE v3),以及在已啟用 Azure Arc 的 Kubernetes 上進行的混合式部署 | Managed 連接器,其會出現在 [ 共享 篩選] 下的連接器資源庫中,而內建連接器會出現在 [ 內建 篩選] 底下的連接器資源庫中,且是以 服務提供者為基礎。 兩個版本都只提供動作,沒有觸發器。 對於關鍵任務工作負載,請使用內建連接器,該連接器在 Azure Logic Apps 執行環境中運行,並可直接透過 TCP/IP 連接 DB2,無需本地資料閘道。 如需詳細資訊,請參閱下列文件: - DB2 受管理連接器參考資料 - DB2 內建連接器參考 - Azure Logic Apps 中的內建連接器 |
受控連接器作業
DB2 管理連接器支援以下資料庫操作,這些操作對應於連接器中對應的動作:
| 資料庫作業 | 連接器動作 |
|---|---|
| 列出資料庫資料表 | 取得資料表 |
| 使用 SELECT 讀取一個資料列 | 取得單一資料列 |
| 使用 SELECT 讀取所有資料列 | 取得多個資料列 |
| 使用 INSERT 加入一個資料列 | 插入資料列 |
| 使用 UPDATE 編輯一個資料列 | 更新資料列 |
| 使用 DELETE 移除一個資料列 | 刪除資料列 |
欲了解更多關於受管理連接器及這些動作的資訊,請參閱 DB2 受管理連接器參考資料。
內建連接器操作
DB2 內建連接器支援以下操作:
| Action | 描述 |
|---|---|
| DB2 資料表 | 回傳 DB2 架構中的資料表。 |
| 刪除列 | 刪除一列或多列。 |
| 執行預存程序 | 執行儲存程序並回傳輸出。 |
| 執行非查詢 | 執行一個不會回傳結果集的 SQL 陳述句。 |
| 執行查詢 | 執行 SQL 查詢並回傳結果集。 |
| 插入列 | 在 DB2 表格中插入一列。 |
| 更新資料列 | 更新 DB2 資料表中的一列或多列。 |
欲了解更多關於內建連接器及這些動作的資訊,請參閱 DB2 內建連接器參考資料。
先決條件
Azure 帳戶和訂用帳戶。 申請一個免費的 Azure 帳號。
IBM DB2 資料庫,無論是雲端或本地端。
你希望用來存取 DB2 資料庫的邏輯應用程式資源和工作流程。
DB2 連接器僅提供動作功能。 如果你的工作流程是空的,你必須先加入一個最適合你情境的 觸發器 。
本指南中的範例使用了 Recurrence 觸發器。
如需詳細資訊,請參閱:
連接需求依接頭版本而異:
管理連接器:若要連接本地的 DB2 資料庫,首先 安裝並設定本地資料閘道。 當 DB2 伺服器在 Azure 中公開或可存取時,閘道器就不是必需的。
內建連接器:本地資料閘道並非必需。 標準邏輯應用程式的主機環境需要對 DB2 伺服器和埠口的網路存取。
新增 DB2 管理連接器動作
以下範例使用 DB2 管理連接器,示範如何新增 Get tables 動作。 若要在標準工作流程中使用內建連接器,請在連接器畫廊中選擇 內建 ,然後選擇 DB2 內建動作,例如 DB2 表格。
備註
新增其他 DB2 動作的步驟類似,只是你提供的動作參數和值不同。
在 Azure 入口網站中,於設計工具內開啟您的邏輯應用程式資源和工作流程。
依照一般步驟加入DB2 名為Get tables 的動作。
連線資訊視窗會打開,讓你能提供連結 DB2 資料庫的詳細資訊。
成功建立連線後,會出現 「取得資料表」 動作資訊窗格,並顯示不需要其他資訊:
繼續 測試你的工作流程並查看輸出表。
為 DB2 管理連接器建立連線
根據你是雲端還是本地 DB2 資料庫,依照步驟操作。 提供必要的連結細節後,選擇 建立新連結,然後返回前一步驟。
在建立與本地資料庫的管理連接器連線之前,務必先安裝 並設定本地資料閘道器。 這個閘道器要求不適用於內建連接器。
| 屬性 | 必要 | 描述 |
|---|---|---|
| 透過內部部署閘道連線 | 否 | 僅適用於本地連線。 |
| 連接名稱 | 是 | 你的連線名稱,例如 ,DB2-connection。 |
| Server | 是 | 例如,你的 DB2 伺服器的位址或別名和埠號 myDB2server.example.com:50000。 注意:這個值是字串,代表 TCP/IP 位址或別名 (採用 IPv4 或 IPv6 格式),後面接著冒號和 TCP/IP 連接埠號碼。 |
| Database | 是 | 你資料庫的名稱。 注意:這個值是字串,代表 DRDA 關聯式資料庫名稱 (RDBNAM): - DB2 for z/OS 接受一個 16 位元組的字串,該資料庫被識別為一個 IBM DB2 for z/OS 位置。 - DB2 for i 接受一個 18 位元組的字串,該資料庫稱為 IBM DB2 for i 關聯式資料庫。 - DB2 for LUW 接受 8 個位元組的字串。 |
| 使用者名稱 | 是 | 資料庫的使用者名稱。 注意:這個值是字串,其長度以特定資料庫為基礎: - DB2 for z/OS 接受 8 個位元組的字串。 - DB2 for i 接受 10 個位元組的字串。 - DB2 for Linux 或 UNIX 接受 8 個位元組的字串。 - DB2 for Windows 接受 30 個位元組的字串。 |
| 密碼 | 是 | 您的資料庫密碼。 |
例如:
設定 DB2 內建連接器的連線
對於關鍵任務的 Standard 工作流程,請使用內建連接器。 內建連接器直接從 Azure Logic Apps 執行環境透過 TCP/IP 連接到你的 DB2 伺服器,且不使用本地的資料閘道。 確保標準邏輯應用程式的主機環境能對 DB2 伺服器及埠口進行網路存取。
在工作流程設計器中,選擇 內建,選擇你想要的 DB2 動作,然後建立連線。 請根據您的 DB2 環境提供以下相關資訊:
| 屬性 | 描述 |
|---|---|
| 連接名稱 | 連線的名稱。 |
| 伺服器名稱 | DB2 伺服器名稱。 |
| 埠號碼 | DB2 伺服器上的資料庫埠號。 |
| Database | DB2 伺服器上的資料庫名稱。 |
| 使用者名稱 | 存取 DB2 伺服器的使用者名稱。 |
| 密碼 | DB2 使用者名稱的密碼。 |
| 套件收集 | 套件集合。 若為空白,則預設為使用者名稱。 |
| 預設結構描述 | schema 呼叫的預設架構,若為空則預設為使用者名稱。 |
| 主機 CCSID | DB2 資料庫的主機編碼字元集識別碼(CCSID)若為空,預設為 1208。 |
| PC 程式碼頁面 | DB2 連線的 PC 代碼頁如果為空,預設為 1208。 |
| 額外連接字串關鍵字 | 可選的 連接字串 關鍵字,以分號分隔。 |
| 連接字串 | DB2 的 連接字串,如果不是空的,則忽略其他屬性。 |
測試你的工作流程並查看輸出表
以下範例顯示來自受控連接器的 Get tables 動作輸出。 你也可以用同樣的方式測試使用內建連接器動作的工作流程。 要手動執行工作流程,請在設計工具列的 執行 清單中選擇 執行。 工作流程結束後,你可以查看這次執行的輸出。
如果執行詳情頁面沒打開,請根據你的邏輯應用程式依照以下步驟操作:
消耗:在 Logic App 側邊欄,在 開發工具下,選擇 Logic app designer。
標準:在工作流程側邊欄,選擇「執行歷史」。
在 執行歷史 清單中,選擇最新的工作流程執行,例如:
消費
Standard
在執行詳情頁面,檢視工作流程中每個步驟的狀態。 要查看每個步驟的輸入與輸出,請選擇該步驟,例如:
要查看 JSON 輸入,請選擇「顯示原始輸入」。
要以 JSON 格式查看輸出,請選擇「顯示原始輸出」。
輸出包含一串表格,例如: