從 Azure Logic Apps 的工作流程連接 IBM DB2 資源

適用於: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 內建連接器參考資料。

先決條件

新增 DB2 管理連接器動作

以下範例使用 DB2 管理連接器,示範如何新增 Get tables 動作。 若要在標準工作流程中使用內建連接器,請在連接器畫廊中選擇 內建 ,然後選擇 DB2 內建動作,例如 DB2 表格。

備註

新增其他 DB2 動作的步驟類似,只是你提供的動作參數和值不同。

  1. 在 Azure 入口網站中,於設計工具內開啟您的邏輯應用程式資源和工作流程。

  2. 依照一般步驟加入DB2 名為Get tables 的動作。

    連線資訊視窗會打開,讓你能提供連結 DB2 資料庫的詳細資訊。

  3. 請依照步驟建立雲端 資料庫 或 本地資料庫的連線,然後返回這裡繼續。

  4. 成功建立連線後,會出現 「取得資料表」 動作資訊窗格,並顯示不需要其他資訊:

    截圖顯示了設計師、工作流程和取得資料表的動作。

  5. 繼續 測試你的工作流程並查看輸出表。

為 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 動作輸出。 你也可以用同樣的方式測試使用內建連接器動作的工作流程。 要手動執行工作流程,請在設計工具列的 執行 清單中選擇 執行。 工作流程結束後,你可以查看這次執行的輸出。

  1. 如果執行詳情頁面沒打開,請根據你的邏輯應用程式依照以下步驟操作:

    • 消耗:在 Logic App 側邊欄,在 開發工具下,選擇 Logic app designer。

    • 標準:在工作流程側邊欄,選擇「執行歷史」。

  2. 在 執行歷史 清單中,選擇最新的工作流程執行,例如:

    • 消費

      截圖顯示了 Consumption 工作流程的執行歷史清單。

    • Standard

      截圖顯示標準工作流程的執行紀錄清單。

  3. 在執行詳情頁面,檢視工作流程中每個步驟的狀態。 要查看每個步驟的輸入與輸出,請選擇該步驟,例如:

    截圖顯示了取得資料表動作的輸入與輸出。

    1. 要查看 JSON 輸入,請選擇「顯示原始輸入」。

    2. 要以 JSON 格式查看輸出,請選擇「顯示原始輸出」。

      輸出包含一串表格,例如:

      截圖顯示了「取得資料表」動作的輸出。