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环境变量设置为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 扩展的测试平台。
错误修复¶
无。