2026 年 Snowflake CLI 版本说明

本文包含 Snowflake CLI 的版本说明,包括以下内容(如果适用):

  • 行为变更

  • 新功能

  • 面向客户的错误修复

有关文档,请参阅 Snowflake CLI

版本 3.16.0(2026 年 3 月 19 日)

新功能和更新

  • 已在预览版中添加对 DCM 命令的支持。

  • 已在列表命令中添加 --in-account 选项(例如 snow object listsnow stage list)。此选项列出账户中给定类型的所有对象。不能与 --in 选项一起使用。

  • 添加了 实验 命令 snow spcs service build-image,用于使用 SPCS 服务构建容器镜像。该命令将本地构建上下文上传到暂存区,执行构建作业,并实时流式传输日志,直到完成。此命令是实验性的,可能会发生变化。

  • snow spcs service execute-job 命令中新增了 --async 选项,用于异步执行作业服务而无需等待完成。

  • snow spcs service execute-job 命令中新增了 --replicas 选项,用于指定要运行的作业副本数量。

  • snow dbt deploysnow dbt execute 命令中新增了 --dbt-version 选项。此选项可在 dbt 项目对象上设置 dbt Core 版本(snow dbt deploy 命令),或者在不更改 dbt 对象的情况下,使用特定的 dbt Core 版本执行 dbt 命令(snow dbt execute 命令)。

  • 所有身份验证器(包括 snowflake-jwt, username_password_mfaworkload_identity)现在不区分大小写。

  • 更改了 snow dbt deploy 命令中临时暂存区完全限定名称的生成方式。dbt 项目对象的完全限定名称中的数据库和架构现在优先于会话中的数据库和架构。

错误修复

  • 修复了 snow stage copy --recursive 在完全限定的暂存区名称中删除数据库和架构限定符的问题,该问题导致命令针对连接的默认数据库而非在 FQN 中指定的数据库解析暂存区。

  • 修复了 :snow streamlit deploy --prune 在使用版本化部署的 Streamlit 实体时,由于暂存区路径格式不正确而导致失败的问题。snow:// 前缀现在在所有暂存区路径操作中都能正确保留。

  • 修复了 snow dbt deploy 的一个错误,该错误会先上传 dbt 项目文件,然后才更新项目属性。例如,如果项目缺少外部访问集成并且指定了依赖项,这可能会导致部署失败。

  • 修复了 snow stage copysnow stage put 命令在本地目录路径包含通配符特殊字符(例如 [id] 或 [slug] 中的方括号)时失败的问题。现在,路径在 glob 扩展之前进行了转义,因此字面量目录名称可以正确匹配。

版本 3.15.0(2026 年 2 月 3 日)

新功能和更新

  • snow object drop 命令和特定于对象的删除命令(例如,snow stage drop)添加了 --if-exists 选项,该选项仅在对象存在时执行删除操作,从而避免因删除不存在的对象而出错。

  • 更新了项目定义,使其支持的 Python 版本与 snowflake-connector-python 保持一致。

错误修复

  • 修复了 git 存储库路径解析,以允许在存储库和分支名称周围加上引号(例如,@"example-repo"/branches/"feature/branch"/*)。

  • 为无界面系统修复了外部浏览器身份验证 (EXTERNALBROWSER) 问题。