用途:通过官方 snow CLI 操作 Snowflake,包括安装校验、连接配置、SQL 执行与对象管理;常见任务走配套封装脚本,仅封装未覆盖的专用命令才直接用官方 CLI。需要 Python 3.10 或更高版本。
主要能力:封装会先校验 snow --help 与 snow --version,缺失时自动运行 uv tool install snowflake-cli,并将可执行文件链接到 ${FREVANA_BIN_DIR}/snow;支持 PAT 连接配置与测试、只读查询与写操作预览、按类型列出/描述/创建/删除对象,以及 Native Apps、Streamlit、Snowpark、阶段、Cortex 等专用命令(需先读 references/official-cli.md)。
使用方式:首次操作前运行 scripts/snowflake.sh check;用 connection-list 与 config-info 查看配置,用 connection-test 测试连接;setup-pat 支持从环境变量读取 PAT,写入后立即测试。SQL 可用 --sql、--file 或模板变量 --variable;只读 SQL 自动执行,其余需先预览再 --execute;多语句写入可用 --single-transaction。
适用场景:需要让 AI 进程以无人值守方式安全访问 Snowflake 的数据查询、对象维护与专用资源管理。
限制:禁止在仓库中存密码、OAuth 密钥、令牌或私钥;PAT 文件须为常规、非符号链接、属主可读且权限 0400/0600;配置文件权限 0600;连接变量替换是文本替换,不可插入不可信值;--local-only 仅阻断基于 URL 的 SQL 引入,不等于无网络或无副作用保证;含 SYSTEM$ 函数的 SQL 一律预览;存在同级 connections.toml 时 setup-pat 会停止;连接名含点或连字符时需显式指定命令选项或通用变量。部分平台与专用命令细节暂未提供。