透過 JDBC 連接器，您可以，在支援 Java® 資料庫連線性 (JDBC) 的內部部署解決方案中，在連鎖中使用指令 執行結構化查詢語言 (SQL) 作業。例如，使用此連接器，您可以
- 執行 SQL 指令，包括
CREATE或UPDATE語句或SELECT查詢 - 擷取資料庫表的詳細資訊
- 透過 JDBC 將記錄插入資料庫
請注意： 若要連線至Amazon® Redshift®,IBM® Db2®,Microsoft® SQL Server®,MySQL®,NetSuite® JDBC 、Oracle® 關聯式資料庫管理系統 (RDBMS) 或自主資料倉庫 (ADW),Postgres®,SAP HANA® JDBC, 或Snowflake®, 請改用其相關的連接器。
必要條件
為了確保 JDBC 連線的安全性，連接器使用基本的使用者名稱和密碼驗證。要設定連接器，您需要
- 在連接的解決方案中設定的指定整合使用者。
- 整合使用者的驗證憑證。
- JDBC 連接的 URL，例如
jdbc:solution://host:port/database - AGroundRunner 專用於連接器，因為不支援 CloudRunner。
- 連接的 JDBC 驅動程式，包括其類別名稱和在 GroundRunner 檔案系統上的路徑。
- 若要在使用此連接器時提供自訂 Java 選項，請設定 GroundRunner 的 JDK_JAVA_OPTIONS 環境變數。 例如，如果您使用的是 Databricks，則會使用下列內容：
JDK_JAVA_OPTIONS="--add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED"。這與安裝和管理 GroundRunner 中設定的組態變數相似。
重要： 設定此變數後，您必須重新開始/重新啟動 GroundRunner 運作的電腦。
附註: 驅動程式必須位於 GroundRunner 上，因為.jar 檔案不能作為資源上傳。
設定 JDBC 連接器
注意：為了使連接器可用於組織的鏈結，組織安全性管理員首先要從組態中啟用它。
- 從Chains（自動化工作流程）建立器 ，按一下Connections ，然後按一下右上方的Create 。
- 在Connector Connection 下 ，選取JDBC 和 GroundRunner 與連線一起使用。
- 在「基本資訊」(Basic Info) 下，輸入唯一的名稱和描述以識別連結。
-
在「屬性」(Properties) 下，輸入連結的詳細資料：
摘要資訊 詳細資料 使用者名稱 輸入連接器整合使用者的使用者名稱。 密碼 輸入Username 屬性的密碼。 連線 URL 輸入 JDBC 連線的 URL，例如 jdbc:solution://host:port/database。JDBC 驅動類 輸入 JDBC 驅動程式 .jar 檔案的類別名稱。例如，對於 Sybase®，請輸入 com.sybase.jdbc.sybdriver。JDBC 驅動程式的路徑 輸入 JDBC 驅動程式在 GroundRunner 檔案系統上的安裝路徑。 注意：所有敏感認證都會自動加密並以進階加密標準 (AES)-256 加密方式儲存。
- 選擇連接使用的環境，然後按一下儲存 。
- 關機並重新開始/重新啟動 GroundRunner 執行的電腦，以重新初始化 JVM。
- 要測試連線，，使用連接器的Get Table Definition 指令建立並執行連線 ，並驗證它是否傳回有效的輸出。
疑難排解
如果 JDBC 連線失敗：
- 驗證整合使用者的驗證憑證。
- 檢查 JDBC 連線的 URL，包括其伺服器、連接埠和資料庫。
- 驗證為連接器輸入的 JDBC 驅動程式類別名稱或路徑。
如果連線無法執行命令，請驗證其輸入（如 SQL 語法或表格）是否有效。