2026 年 Snowflake Connector for Python 版本说明

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

  • 行为变更

  • 新功能

  • 面向客户的错误修复

Snowflake 对 Snowflake Connector for Python 更新使用语义版本控制。

有关文档,请参阅 Snowflake Connector for Python

版本 4.4.0(2026 年 3 月 25 日)

新功能和更新

  • 将 :codenowrap:` cryptography ` 包的最低版本提升至 46.0.5,以解决 CVE-2026-26007。

  • 添加了对 Python 3.14 的支持。

  • 移除了 pyOpenSSL 的上限依赖约束,以允许安装 :codenowrap:`pyOpenSSL`26.0.0+,其中包含对 GHSA-vp96-hxj8-p424 的修复。

已弃用的功能

  • 将用于跳过配置文件权限警告的环境变量从 SF_SKIP_WARNING_FOR_READ_PERMISSIONS_ON_CONFIG_FILE 重命名为 SF_SKIP_TOKEN_FILE_PERMISSIONS_VERIFICATION。旧变量仍受支持,但会产生弃用警告。

错误修复

  • 修复了 Azure IMDS:codenowrap:Metadata 标头使用小写 "true" 而非 "True" 的问题,该问题会在 Azure 工作负载身份联合身份验证期间导致 400 错误。

  • 将默认的 crl_download_max_size 修复为 20MB 而不是 200MB,以防止潜在的内存不足问题。

  • 修复了以下错误:Azure GET 命令在获取元数据时,会将文件状态错误地设置为 UPLOADED,而不是保留 DOWNLOADED 状态。

  • 修复了在读取 connections.toml 时未正确应用 unsafe_skip_file_permissions_check 标志的问题。

  • 修复了在提取大型结果集时,result_batch._load() 中的 JSONDecodeError 问题。

版本 4.3.0(2026 年 2 月 12 日)

已弃用的功能

  • 已弃用对 OCSP 响应缓存反序列化中自定义吊销错误类的支持。

    默认情况下,仅会从 OCSP 缓存中反序列化 RevocationCheckError 异常。通过将 SNOWFLAKE_ENABLE_CUSTOM_REVOCATION_ERRORS 环境变量设置为 true1,可以临时启用自定义异常类,但此支持将在未来版本中移除。

新功能和更新

  • 已将供应商提供的 urllib3 升级至版本 2.6.3。

  • cursor.fetch_arrow_allcursor.fetch_pandas_all 添加了 force_microseconds_precision,以免批次间出现 PyArrow 架构不一致的问题。

  • 在将 HTTP 协议用于 OAuth URLs 时添加了警告。

  • 更新了 SnowflakeConnection 中的 server_session_keep_alive 参数,以跳过对待处理的异步查询的检查,从而提供更快的连接关闭时间,尤其是在执行大量异步查询时。

错误修复

  • 修复了 INTERVAL YEARINTERVAL MONTH 类型的字符串表示形式。

  • 确保了正确的列表转换;转换器现在会对所有列表项运行 to_snowflake

版本 4.2.0(2026 年 1 月 7 日)

新功能和更新

  • 添加了 SnowflakeCursor.stats 属性,以便在 rowcount 不足的情况下,为 CTAS 等操作公开粒度化的 DML 统计信息(插入、删除、更新和重复的行)。

  • 添加了对将 Snowpark Container Services (SPCS) 服务标识符令牌 (SPCS_TOKEN) 注入登录请求的支持(当其存在于 SPCS 容器中时)。

  • 引入了用于扩展遥测的共享库,以识别和准备原生 Rust 扩展的测试平台。

错误修复

  • 无。