2025 年 Snowflake CLI 版本说明

本文包含 Snowflake CLI 的版本说明，包括以下内容（如果适用）：

  • 行为变更

  • 新功能

  • 面向客户的错误修复

有关文档，请参阅 Snowflake CLI。

版本 3.6.0（2025 年 4 月 2 日）

新功能和更新

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

错误修复

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

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

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

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

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

版本 3.5.0（2025 年 3 月 10 日）

新功能和更新

  • 扩展项目定义 (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 命令中的数据类型处理问题。

版本 3.4.0（2025 年 2 月 13 日）

新功能和更新

  • 为应用程序包实体添加了可选的 stage_subdirectory 字段。指定此值时，应用程序工件将上传到此子目录，而不是应用程序包暂存区的根目录。

  • 添加了以下 snow spcs service 命令：

    • snow spcs service events 检索服务特定事件。

    • snow spcs service metrics 获取服务指标。

  • 添加了以下 snow app release-directive 命令：

    • snow app release-directive add-accounts 会将账户添加到发布指令中。

    • snow app release-directive remove-accounts 会从发布指令中移除账户。

  • 添加了 snow app release-channel set-accounts 命令，可为发布渠道设置账户。

  • 向 Snowpark deploy 命令添加了 --force-replace 选项，以便在未检测到任何更改的情况下替换实体。

  • 添加了以下笔记本功能：

    • 添加了 snow notebook deploy 命令，允许使用本地文件创建笔记本。

    • 添加了对容器化笔记本的支持。

    • 在 snow object 命令支持的对象类型中添加了 notebook。

  • 在 Streamlit 和 Snowpark:file:snowflake.yyml 文件中的工件路径中添加了对 glob 模式（** 除外） 的支持。

    备注

    在 Snowpark snowflake.yml 文件中使用 glob 模式需要启用 ENABLE_SNOWPARK_GLOB_SUPPORT 功能标志。

  • 添加了对 Mac OS x86_64 架构的支持。

错误修复

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

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

版本 3.3.0（2025 年 1 月 21 日）

备注

2025 年 1 月 28 日，Snowflake 更新了 snow add release channel 命令的文档，指示该功能处于公开预览阶段，而非正式发布阶段。

新功能和更新

  • 添加了以下 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 命令，以保留命令行连接选项。

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

语言: 中文