snowflake-connections

此技能針對 Snowflake 連線設定提供集中化管理方案，採用 connections.toml 格式，適用於包含 Snowflake CLI、Streamlit 應用程式與 Snowpark 管線的現代數據工程工作流程。本技能專為數據工程師、開發者及平台管理員設計，協助其安全地管理開發、測試與生產等多重環境下的連線能力。本技能引導使用者了解連線參數的技術規範，包含帳號識別碼、倉庫指派、資料庫環境與結構路徑，確保應用程式能持續且準確地與正確的資料基礎設施互動。

• 支援多種驗證方式：外部瀏覽器 (SSO)、金鑰配對 (snowflake_jwt)、使用者名稱/密碼與 OAuth 權杖。

• 管理位於 ~/.snowflake/connections.toml 或 %USERPROFILE%/.snowflake/connections.toml 的 connections.toml 設定檔。

• 關於使用設定檔區塊管理多環境的指導，便於在開發、測試與生產環境間切換。

• 安全最佳實踐，包含加密金鑰配對儲存與輪替建議、避免寫死憑證，以及使用環境變數處理敏感資訊。

• 針對驗證錯誤、連線逾時及多重身分驗證 (MFA) 相關問題的故障排除協助。

• 自動化 CI/CD 管線的整合模式，特別強調在無人參與 (headless) 環境下使用金鑰配對驗證。

• 使用者應利用此技能設定本機開發環境、容器化應用程式或 CI/CD 執行器設定。

• 請注意，儘管驗證原則與 dbt 一致，但本技能專注於 connections.toml；若涉及 dbt 特有的 profiles.yml，請參閱 dbt-core 技能。

• 預期的輸入內容包含設定參數、環境需求或與連線相關的錯誤訊息。

• 輸出結果通常為經過驗證的連線設定、結構化的 toml 片段，或是針對存取問題的逐步解決方案。

• 限制：僅適用於 Snowflake 原生連線管理；不涵蓋一般的網路防火牆或代理伺服器設定。