2025 年 Snowflake Connector for Python 版本说明¶

新功能和更新¶

• 无。

错误修复¶

• 增强了配置文件权限的警告消息。

  • 改进了可读权限问题的警告消息，增加了如何使用 SF_SKIP_WARNING_FOR_READ_PERMISSIONS_ON_CONFIG_FILE 环境变量跳过警告的清晰说明。

• 修复了在 AWS 上暂存 pandas dataframes 的错误 – 在需要时会使用区域端点。

  • 此修复解决了 Snowpark 中 create_dataframe 调用的问题。

新功能和更新¶

• 无。

错误修复¶

• 新增了通过将 platform_detection_timeout_seconds 设置为 0，禁用基于端点的平台检测的功能。

• 修复了 platform_detection 对不存在端点的失败请求重复尝试并发出警告的错误。

新功能和更新¶

• 在 write_pandas 中新增了 infer_schema 参数，用于对传入数据执行架构推断。

错误修复¶

• 将 snowflake 命名空间恢复为非模块形式。

新功能和更新¶

• Added support for workload identity federation in the AWS, Azure, Google Cloud, and Kubernetes platforms.

  • 添加了 workload_identity_provider 连接参数。

  • 在 authenticator 连接参数的值中添加了 WORKLOAD_IDENTITY。

• 新增 unsafe_skip_file_permissions_check 标志，用于跳过缓存和配置文件的权限检查。

• Added basic JSON support for Interval types.

• 在 ResultMetadata 中为 Interval 类型新增 type_code 填充功能。

• 放宽了 pyarrow 版本限制；现在可以使用版本 >= 19。

• 在连接对象中引入了 snowflake_version 属性。

• Added support for the use_vectorized_scanner parameter in the write_pandas function.

• 新增通过连接参数设置代理的支持，无需设置环境变量。

错误修复¶

• 修复了 OAuth 身份验证器的值问题。

• 修复了在使用带外部会话身份验证器的 PAT 时，如果在 SnowflakeRestful.fetch 中未提供 external_session_id 会导致的错误。

• 修复了 OAuth 和 programmatic_access_token 身份验证器值的大小写敏感问题。

• 修复了身份验证器值不正确时错误信息不清晰的问题。

• 修复了 GCS 暂存问题，确保端点包含架构。

• 修复了在以 pandas.DataFrame 或 pyarrow.Table 获取带时区的时间戳时，由于不必要的精度导致的溢出问题。现在如果无法防止溢出，会抛出明确的错误。

新功能和更新¶

• 添加了 client_fetch_use_mp 连接参数，该参数支持对结果批次进行多处理获取，这通常会缩短提取时间。

• 添加了对带外部会话 ID 的新个人访问令牌 (PAT) 身份验证机制的支持。

• 在 write_pandas 函数中添加了 bulk_upload_chunks 参数。如果将此参数设置为 True，则会更改 write_pandas 函数的行为，即先将所有数据块写入到本地磁盘，然后将数据块文件夹以通配符的形式上传至暂存区。当设置为 :codenowrap:`False`（默认）时，数据块将逐一保存、上传和删除。

• 添加了对 Python 3.13 的 Windows 支持。

• 添加了对 Interval 类型的支持。

• 为本地应用程序添加了对 Snowflake OAuth 的支持。

错误修复¶

• 修复了位置名称中 write_pandas 特殊字符使用的问题。

• 修复了为 Google Cloud Storage (GCS) 客户端构建位置时使用 use_virtual_url 的问题。

非公开预览版 (PrPr) 功能¶

Added support for workload identity federation in the AWS, Azure, GCP and Kubernetes platforms.

免责声明：

• 只有将 SF_ENABLE_EXPERIMENTAL_AUTHENTICATION 环境变量设置为 true 时，才能使用此功能。

• 应仅在非生产数据中使用此功能。

• 此 PrPr 功能不在支持范围内。但在 PrPr 阶段，产品和工程团队可提供服务。

• 如需了解参与情况和相关文档，请联系您的客户团队。

新功能和更新¶

• 添加了对 OAuth 2.0 授权代码流、OAuth 2.0 客户端凭据流和 OAuth 令牌缓存的全新身份验证方法支持。

  • 对于 OAuth 2.0 授权代码流：

    • 添加了 oauth_client_id、oauth_client_secret、oauth_authorization_url、oauth_token_request_url、oauth_redirect_uri、oauth_scope、oauth_disable_pkce、oauth_enable_refresh_tokens 和 oauth_enable_single_use_refresh_tokens 参数。

    • 为参数身份验证器添加了 OAUTH_AUTHORIZATION_CODE 值。

  • 对于 OAuth 2.0 客户端凭据流：

    • 添加了 oauth_client_id、oauth_client_secret、oauth_token_request_url 和 oauth_scope 参数。

    • 为参数身份验证器添加了 OAUTH_CLIENT_CREDENTIALS 值。

  • 对于 OAuth 令牌缓存：需要将用户名传递给驱动程序配置，并且 client_store_temporary_credential property 属性不能设置为 true。

错误修复¶

• 将所需的最低 boto 和 botocore 版本设为 1.24。

• 修复了 OSCP 在已获得可信证书的情况下终止证书链遍历的问题。

非公开预览版 (PrPr) 功能¶

• 添加了 client_fetch_threads 实验参数，以更好地利用线程来提取查询结果。

• 添加了新的实验性身份验证方法：

  • OAuth 授权码和客户端凭据流。

  • 适用于 AWS、Azure、GCP 和 Kubernetes 平台的工作负载身份联合。

免责声明：

• 这些功能只能通过将 SF_ENABLE_EXPERIMENTAL_AUTHENTICATION 环境变量设置为 true 来访问。

• 这些功能仅应在非生产数据中使用。

• 这些 PrPr 功能不在支持服务的覆盖范围内。但在 PrPr 阶段，产品和工程团队可提供服务。

• 如需了解参与情况和相关文档，请联系您的客户团队。

新功能和更新¶

• 添加了对 Python 3.13 的支持。

  备注

  Windows 64 支持仍处于试验阶段，不应用于生产环境。

• 移除了对 Python 3.8 的支持。

• 添加了对基本十进制 floating-point 类型的支持。

• 添加了在 password 字段中提供 PAT 的支持。

• 添加了对 GCS 区域端点的支持。

• 添加了对 GCS 虚拟 URLs 的支持。有关更多信息，请参阅 请求端点 (https://cloud.google.com/storage/docs/request-endpoints#xml-api)。

• 添加了相关支持，允许连接器继承在上游生成的 UUID4，它在语句参数（字段：requestId）中提供，而非自动生成 UUID4 用于 HTTP 请求 ID。

• 改进了 urllib3、boto3 和 botocore 库中的日志记录，以确保即使将来迁移到外部自有库之后，仍能进行数据掩码。

• 将某些消息的日志级别从 info 降低到了 debug，确保输出更易于理解。

• 提高了临时凭据缓存存储的安全性和稳健性。

• 启用了 insecure_mode 连接属性，并替换为 disable_ocsp_checks，行为与先前的属性相同。

• 实施并改进了 Linux 基于文件的凭据缓存，包括增强的令牌缓存。

错误修复¶

• 改进了因超时而取消客户端查询的错误消息。

• 修复了一个错误，该错误导致驱动程序在 TO_DATE 行转换为 python 时，遇到无效日期之后是正确的日期时发生静默失败。

• 添加了 check_arrow_conversion_error_on_every_column 连接属性，可设置为 False 以恢复先前行为，即驱动程序忽略错误，直至错误出现在最后一列。此选项可让您解锁可能受错误修复影响的工作流程，这些工作流程将在后续版本中移除。

• 修复了过期的 S3 凭据更新和发现过期凭据时进行递增重试的问题。

新功能和更新¶

• 将 pyOpenSSL 依赖项上边界从 <25.0.0 升级到 <26.0.0。

• 优化了分发包查找，以提高导入速度。

• 为 write_pandas 增加了对 Iceberg 表的支持。

• 增加了对 File 类型的支持。

错误修复¶

• 为 pyarrow 添加了 <19.0.0 pin，作为影响 Azure Batch 的一个错误的一种解决方法。

• 修复了以大写形式指定 privatelink 账户名称时，无法确定 privatelink OCSP 缓存 URL 的错误。

• 修复了 base64 编码的私钥测试。

• 修复了 Windows 上文件权限检查的一个错误。

• 添加了 unsafe_file_write 连接参数，用于恢复先前使用带有 644 权限的 GET 下载的文件的保存行为。

新功能和更新¶

• 连接器不再使用限定范围的临时对象。

错误修复¶

• 无。

新功能和更新¶

• 无。

错误修复¶

• 针对 SQL 注入强化了 snowflake.connector.pandas_tools 模块。有关更多信息，请参阅 CVE-2025-24793 (https://github.com/snowflakedb/snowflake-connector-python/security/advisories/GHSA-2vpq-fh52-j3wv)。

• 本地 OCSP 缓存已更新，以使用 json 模块而不是 pickle 来序列化其内容。有关更多信息，请参阅 CVE-2025-24794 (https://github.com/snowflakedb/snowflake-connector-python/security/advisories/GHSA-m4f6-vcj4-w5mx)。

• Linux 凭据缓存文件权限已明确更新为仅对所有者可读。有关更多信息，请参阅 CVE-2025-24795 (https://github.com/snowflakedb/snowflake-connector-python/security/advisories/GHSA-r2x6-cjg7-8r43)。

• 更新了使用 GET 下载的文件的文件权限，仅允许文件所有者读取。

新功能和更新¶

• 添加了 iobound_tpe_limit 连接参数，以限制 PUT 和 GET 命令期间 IO-bound ThreadPoolExecutors 的大小。默认情况下，大小按文件数和 CPU 核心数中的较小值计算。

• 添加了 Connection.is_valid() 方法，用于验证连接是否足够稳定，可以接收查询。

• 将光标块 rowcount 的日志级别从 INFO 更新到 DEBUG。

• 在 private_key 身份验证类型中增加了对 base64 编码的 DER 私钥字符串的支持。

• 已更新 README.md，以包括有关如何使用 cosign 验证包签名的说明。

错误修复¶

• 无。