2026 年 Snowflake Connector for Python 版本说明

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

  • 行为变更

  • 新功能

  • 面向客户的错误修复

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

有关文档，请参阅 Snowflake Connector for Python。

版本 4.3.0（2026 年 2 月 12 日）

已弃用的功能

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

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

新功能和更新

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

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

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

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

错误修复

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

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

版本 4.2.0（2026 年 1 月 7 日）

新功能和更新

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

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

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

错误修复

  • 无。