2025 年 Snowflake CLI 版本说明¶

Added the !edit command to the snow sql command to support external editors.

Added the --partial option to the snow logs command to support partial, case-insensitive matching of log messages.

Improved parsing !source with trailing comments.

Upgraded to typer=0.17.3 to improve the display of help messages.

Improved output handling with streaming queries in the snow sql command.

Fixed crashes with older x86_64 Intel CPUs.

Fixed the ! commands in snow sql commands so they no longer require a trailing ; for evaluation.

Fixed using ctx.var in snow sql with Jinja templating.

Fixed issues when pasting content with trailing new lines.

Fixed an issue with snow snowpark deploy failing on duplicated packages.

Fixed an issue causing a snow spcs logs IndexOutOfRange error.

无。

无

Fixed snow dbt deploy command to properly handle fully qualified names.

Fixed snow dbt deploy command to properly handle local directories with dots in names.

此版本在 Snowflake Native App Framework 中弃用了 Snowpark 处理器。

添加了对使用 --token 选项传递 OAuth 令牌的支持。

添加了抑制新 Snowflake CLI 版本消息的功能。

添加了以下新 --format 选项，用于输出数据：

• CSV，将查询输出格式化为 CSV。

• JSON_EXT，以 JSON 对象而不是字符串的形式输出 JSON。

为 snow sql 命令添加了 --enabled_templating 选项，允许您指定在解析变量时使用以下哪些模板：

• 标准 (<% ... %>)，默认情况下处于启用状态。

• 旧版 (&{ ... })，默认情况下处于启用状态。

• Jinja ({{ ... }})，默认情况下处于禁用状态。

在 snowflake.yml 架构中为 artifact_repository_packages 添加了 packages 别名。

添加了 snow stage copy @src_stage @dst_stage 命令，用于直接在两个命名暂存区之间复制文件。

添加了对 DBT deploy、execute 和 list 命令的支持。

修复了 snow sql 命令在 snowflake.yml 无效且查询没有模板时会失败的问题。

修复了 Decimal、time 和:codenowrap:binary 数据类型的 JSON 序列化问题。

为 snow spcs image-registry login 命令添加了 --private-link 选项，以使用专用链接 URLs 登录。

无。

为 snow stage create 命令添加了 --encryption 选项，以定义为暂存区中的所有文件使用的加密类型。

修复了在未设置当前数据库时，use 命令出现的错误。

无

为 snow spcs image-registry url 命令添加了 --private-link 选项，用于检索专用链接 URLs。

无

将 enable_release_channels 属性默认值从 False 更改为 None。

无

升级消息现在会发送到 stderr。

修复了较新 Python 版本上的 snowflake.core 导入问题。

添加了对 OAuth 令牌的支持。

为 snow sql 命令添加了如下增强：

• 添加了交互模式。

• 添加了对异步 SQL 查询的支持。

• 添加了对 !queries、!result 和 !abort SQL 查询命令的支持。

• 添加了 --single-transaction 命令行选项，用于将多个 SQL 查询作为“全部执行或全部不执行”的批次进行处理，确保在提交任何更改之前成功完成所有命令。

• 在 Snowpark 实体模型中添加了 artifact_repository 字段，以支持使用非 anaconda 包。

修复了在 requirements.txt 中使用 != 运算符时部署 Snowpark 项目的问题。

修复了 use 命令的转义标识符的问题。

将 enable_release_channels 参数从全局级别移至项目级别。

修复了 snow spcs service metrics 命令以接受完全限定的服务名称。

无。

修复了帮助消息中显示错误的问题。

无。

修复了证书连接问题。

修复了 snow spcs image-registry 登录查询速度慢的问题。

向 snow notebook deploy、snow snowpark deploy 和 snow streamlit deploy 命令添加了 --prune 选项，移除暂存区中存在但本地文件系统中不存在的文件。

添加了 snow logs 命令，用于从服务器检索和流式传输日志。

添加了 snow helper check-snowsql-env-vars，报告来自 SnowSQL 的环境变量及其 Snowflake CLI 替代项目。

更新了 MacOS 安装后脚本，以在需要时更新 PATH 环境变量，确保 snow 命令可用。

添加了对 SQL 查询 !source 命令的支持，允许从本地文件执行 SQL。

修复了 snow spcs compute-pool 命令中不兼容的选项不引发错误的问题。

更改了二进制构建，支持嵌入整个 Python 环境。

修复了在不平衡的目录树中递归复制到暂存区的问题。

修复了检查 Snowflake CLI 新版本时的问题。

在 snow stage 和 snow git 命令中添加了文件执行日志。

扩展项目定义 (snowflake.yml) 支持以下 SPCS (Snowpark Container Services) 实体：

• 计算池

• 镜像仓库

• 服务

添加了 snow spcs compute pool deploy 命令，可读取 snowflake.yml 项目定义文件。

添加了 snow spcs image repository deploy 命令，可读取 snowflake.yml 项目定义文件。

添加了 snow spcs service deploy 命令，可读取 snowflake.yml 项目定义文件。

修复了在输出格式使用 JSON 时，snow sql 命令中的数据类型处理问题。

修复了 Snowflake CLI 二进制安装文件中的 MFA 缓存问题。

修复了 Snowflake CLI 二进制安装文件中的自动补全问题。

添加了以下 Snowflake Native Apps 功能和更新：

• 添加了以下命令以支持发布指令：

  • snow app release-directive list

  • snow app release-directive set

  • snow app release-directive unset

• 添加了对发布渠道的支持，包括以下内容：

  • 在 snow app version create 和 snow app version drop 命令中添加了支持发布渠道。

  • 添加了在使用发布指令 (snow app run --from-release-directive --channel=<channel>) 创建应用程序实例时指定发布渠道的功能。

  • 添加了 snow app release-channel list 以列出可用的发布渠道。

  • 添加了 now app release-channel add-accounts 和 snow app release-channel remove-accounts 命令，以支持向发布渠道添加账户和从发布渠道移除账户。

  • 添加了 snow app release-channel add-version 和 snow app release-channel remove-version 命令，以向发布渠道添加版本和从发布渠道移除版本。

• 添加了 snow app publish 命令，以简化将版本发布到发布渠道和更新发布指令。

• 对 snow app version create 命令进行以下更改：

  • 该命令现在以 JSON 格式返回版本、补丁和标签。

  • 添加了 --from-stage 选项，以允许从暂存区的内容创建版本，而无需重新同步到暂存区。

添加了 snow helpers import-snowsql-connections 命令，以从现有 SnowSQL 配置导入连接。

添加了对仅限制用户访问 Snowflake CLI 的支持。有关更多信息，请参阅 添加仅限制对 Snowflake CLI 的访问的身份验证策略。

修复了无法将补丁添加到小写引号版本的问题。

修复了在未提供标签时，将标签设置为空，而不是 None 的问题。

修复了 snow connection generate-jwt 命令，以保留命令行连接选项。

修复了笔记本命令的暂存区路径处理。