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 原生连接管理；不涵盖一般的网络防火墙或代理服务器配置。