2025 年 Snowflake CLI 版本说明¶
本文包含 Snowflake CLI 的版本说明,包括以下内容(如果适用):
行为变更
新功能
面向客户的错误修复
有关文档,请参阅 Snowflake CLI。
版本 3.9.1(2025 年 6 月 9 日)¶
新功能和更新¶
为
snow spcs image-registry login
命令添加了--private-link
选项,以使用专用链接 URLs 登录。
错误修复¶
无。
版本 3.9.0(2025 年 5 月 29 日)¶
新功能和更新¶
为
snow stage create
命令添加了--encryption
选项,以定义为暂存区中的所有文件使用的加密类型。
错误修复¶
修复了在未设置当前数据库时,
use
命令出现的错误。
版本 3.8.3(2025 年 5 月 22 日)¶
新功能和更新¶
无
错误修复¶
为
snow spcs image-registry url
命令添加了--private-link
选项,用于检索专用链接 URLs。
版本 3.8.2(2025 年 5 月 21 日)¶
新功能和更新¶
无
错误修复¶
将
enable_release_channels
属性默认值从False
更改为 None。
版本 3.8.1(2025 年 5 月 20 日)¶
新功能和更新¶
无
错误修复¶
升级消息现在会发送到
stderr
。修复了较新 Python 版本上的
snowflake.core
导入问题。
版本 3.8.0(2025 年 5 月 16 日)¶
新功能和更新¶
添加了对 OAuth 令牌的支持。
为
snow sql
命令添加了如下增强:添加了交互模式。
添加了对异步 SQL 查询的支持。
添加了对
!queries
、!result
和!abort
SQL 查询命令的支持。添加了
--single-transaction
命令行选项,用于将多个 SQL 查询作为“全部执行或全部不执行”的批次进行处理,确保在提交任何更改之前成功完成所有命令。
在 Snowpark 实体模型中添加了
artifact_repository
和artifact_repository_packages
字段,以支持使用非 anaconda 包。
错误修复¶
修复了在
requirements.txt
中使用!=
运算符时部署 Snowpark 项目的问题。修复了
use
命令的转义标识符的问题。将
enable_release_channels
参数从全局级别移至项目级别。修复了
snow spcs service metrics
命令以接受完全限定的服务名称。
版本 3.7.2(2025 年 5 月 12 日)¶
新功能和更新¶
无。
错误修复¶
修复了帮助消息中显示错误的问题。
版本 3.7.1(2025 年 4 月 28 日)¶
新功能和更新¶
无。
错误修复¶
修复了证书连接问题。
修复了
snow spcs image-registry
登录查询速度慢的问题。
版本 3.7.0(2025 年 4 月 16 日)¶
新功能和更新¶
向
snow notebook deploy
、snow snowpark deploy
和snow streamlit deploy
命令添加了--prune
选项,移除暂存区中存在但本地文件系统中不存在的文件。添加了
snow logs
命令,用于从服务器检索和流式传输日志。添加了
snow helper check-snowsql-env-vars
,报告来自 SnowSQL 的环境变量及其 Snowflake CLI 替代项目。
错误修复¶
更新了 MacOS 安装后脚本,以在需要时更新
PATH
环境变量,确保snow
命令可用。
版本 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
命令,以保留命令行连接选项。修复了笔记本命令的暂存区路径处理。