使用 Snowflake® JDBC 連接器，您可以在連鎖中使用命令 在 Snowflake 資料庫中執行結構化查詢語言 (SQL) 作業。例如，使用此連接器，您可以：
- 執行 SQL 指令，包括
CREATE或UPDATE語句或SELECT查詢 - 擷取 Snowflake 中資料表的詳細資訊
- 將記錄插入 Snowflake 資料庫
註: 此連接器由 Workiva 建立並連接至第三方系統。雖然我們的支援團隊可協助您在工作區內設定此連接器，但我們無法排除故障或協助解決任何源自 Workiva 平台以外的問題。
必要條件
若要啟用與 Snowflake 的連線，組織安全管理員必須先啟用 fromConfiguration 。
連接器本身使用 Java 資料庫連線 (JDBC)，以基本驗證或鑰匙對驗證方式保護。若要設定連接器，您需要
- 在 Snowflake 中為連接器建立的指定整合使用者，加上整合使用者的使用者名稱和密碼。
注意: 自 2025 年 11 月起將不再支援 Basic auth。我們建議改用鑰匙對認證。深入了解。
- (可選） 私密金鑰檔案，以啟用金鑰對驗證.
- JDBC 連接的 URL，例如
jdbc:snowflake://[accountName].snowflakecomputing.com/?[options] 。 - 若要連接至內部部署的 Snowflake 資料庫，連接的 GroundRunner 。(若要連接至 Snowflake 的雲端實例，請使用預設的 CloudRunner）。
設定 Snowflake 連接器
- 在「鏈結產生器」中，按一下「連線」，然後按一下右上角的「建立」。
- 在Connector Connection 下 ，選擇Snowflake JDBC 和與連接一起使用的執行器。
- 在「基本資訊」(Basic Info) 下，輸入唯一的名稱和描述以識別連結。
- (可選）在Resources 下，上傳您的私人密碼匙檔案。您需要在下一步的「私人密碼匙檔案」欄位中輸入確切的檔案名稱。
- 在Properties 下 ，輸入連接器的詳細資訊：
摘要資訊 詳細資料 使用者名稱 輸入要驗證的使用者名稱。如果下面提供了私人密碼匙檔案，它會自動驗證此使用者名稱。 密碼 輸入Username 屬性的密碼。如果下面提供了私密金鑰檔案，請在此輸入密碼。
註： 未加密的金鑰檔案請留空。
連線 URL 輸入 JDBC 連接的 URL，例如
jdbc:snowflake://[accountName].snowflakecomputing.com/。若要包含連線的選用屬性 ，請將它們追加為查詢字串。 例如，若要在一分鐘內無法連線時自動超時登入，請附加
?loginTimeout=60。私密金鑰檔案 (可選） 用於使用伺服器的公開金鑰進行驗證。使用者名稱和密碼應輸入上述欄位。
進一步瞭解：金鑰對驗證和金鑰對輪換
注意: 檔案名稱必須與作為連線資源上載的檔案相符。
注意：所有敏感認證都會自動加密並以進階加密標準 (AES)-256 加密方式儲存。為了安全起見，避免在Connection URL 屬性中包含使用者憑證作為可選屬性。
- 選擇連接使用的環境，然後按一下儲存 。
- 要測試連線，，使用連接器的Get Table Definition 指令建立並執行連線 ，並驗證它是否傳回有效的輸出。
疑難排解
- 如果與 Snowflake 的連接失敗：
- 驗證驗證憑證。
- 如果使用key-pair auth，請確保通過Resources 上傳的檔案名稱與Private Key File 欄位中輸入的檔案名稱相符。
- 檢查 JDBC 連線的 URL，包括其帳號名稱。
- 如果連接至內部部署資料庫，請檢查連接器所選的 GroundRunner。
- 如果連線無法執行命令，請驗證其輸入，例如其 SQL 語法或表格是否有效。
- 如果 Snowflake 命令失敗，並顯示錯誤訊息Incoming request with IP/Token XX.XX.XX.XX is not allowed to access Snowflake ，請參考此Snowflake 文章 ，以獲得將所需 IP 位址（CloudRunner 或 GroundRunner）新增至您的 Snowflake 實例中的 Allowed IP 清單的指引。