2025 年 ODBC Driver 版本说明

本文包含 ODBC Driver 的版本说明，包括以下内容（如果适用）：

  • 行为变更

  • 新功能

  • 面向客户的错误修复

Snowflake 对 ODBC Driver 更新使用语义版本控制。

有关文档，请参阅 ODBC 驱动程序。

Version 3.11.1 (October 21, 2025)

新功能和更新

  • 无。

错误修复

  • Fixed a bug with numeric data conversion when using bulk fetching.

Version 3.10.1 (October 21, 2025)

新功能和更新

  • 无。

错误修复

  • Fixed a bug with numeric data conversion when using bulk fetching.

Version 3.9.1 (October 20, 2025)

新功能和更新

  • 无。

错误修复

  • Fixed a bug with numeric data conversion when using bulk fetching.

Version 3.8.1 (October 20, 2025)

新功能和更新

  • 无。

错误修复

  • Fixed a bug with numeric data conversion when using bulk fetching.

Version 3.7.1 (October 20, 2025)

新功能和更新

  • 无。

错误修复

  • Fixed a bug with numeric data conversion when using bulk fetching.

Version 3.12.0 (October 14, 2025)

新功能和更新

  • Improved performance of the multi-threaded bulk fetching workflow.

错误修复

  • Fixed a bug that, during OIDC usage, the token was not required, causing errors.

  • Fixed the MacOS release to include the x86_64 architecture.

  • Fix a bug with DEFAULT_VARCHAR_SIZE in configuration of the default varchar length parameter.

  • Fixed a bug with numeric data conversion when using bulk fetching.

Version 3.11.0 (August 13, 2025)

新功能和更新

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

    • Added the workload_identity_provider connection parameter.

    • Added WORKLOAD_IDENTITY to the values for the authenticator connection parameter.

  • Added the following configuration parameters:

    • DisableTelemetry to disable telemetry.

    • SSLVersionMax to specify the maximum SSL version.

  • Added the PRIV_KEY_BASE64 and PRIV_KEY_PWD connection parameters that allow passing a base64-encoded private key.

错误修复

  • Fixed an issue with the in-band telemetry event handler to properly reset the events.

  • Fixed the HTTP headers used to authenticate via OKTA.

  • Removed the trailing slash from the default RedirectUri within the OAuth Authorization process.

版本 3.10.0（2025 年 7 月 7 日）

非公开预览版 (PrPr) 功能

  • Added support for sovereign clouds for workload identity federation (WIF).

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

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

    • 这些 PrPr 功能不受支持。但在 PrPr 期间，可以向产品和工程团队进行咨询。

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

新功能和更新

  • 添加了对在 TOML 文件中配置连接参数的支持。

错误修复

  • 修复了支持虚拟式域的问题。

  • 修复了可能导致缓冲区溢出的问题。

版本 3.9.0（2025 年 6 月 12 日）

非公开预览版 (PrPr) 功能

  • 添加了对 AWS、Azure、GCP 和 Kubernetes 平台中工作负载身份联合的支持。

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

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

    • 这些 PrPr 功能不受支持。但在 PrPr 期间，可以向产品和工程团队进行咨询。

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

新功能和更新

  • 为 oauth_client_id 和 oauth_client_secret OAUTH 参数添加了 LOCAL_APPLICATION 默认值。

  • 使用密钥对身份验证参数 PRIV_KEY_FILE 和 PRIV_KEY_FILE_PWD 扩展了 ODBC 驱动程序的 Windows UI。

  • 增加了对虚拟式域的支持。

  • 添加了 DriverManagerOverride 配置参数，该参数允许在 Linux 和 MacOS 上指定驱动程序管理器。

  • 将驱动程序升级到了 SimbaSDK 10.3。

错误修复

  • 修复了提取取消请求时抛出的错误信息不正确的问题。

  • 修复了先使用批量提取（在每次提取调用中检索多行），然后切换到单行模式时触发的可能崩溃问题。

  • 修复了处理简易日志记录配置可能会中断连接的问题。

  • 修复了会话恢复时可能导致内存不足问题的 OCSP 验证问题。

版本 3.8.0（2025 年 4 月 30 日）

新功能和更新

  • 添加了对 PAT（编程访问令牌）、OAuth 2.0 授权代码流、OAuth 2.0 客户端凭据流及 OAuth 令牌缓存的支持：

    • 对于 PAT：

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

    • 对于 OAuth 2.0 授权代码流：

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

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

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

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

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

    • 对于 OAuth 令牌缓存：

      • 需要将 UID（用户名）传递给驱动程序配置，并且 client_store_temporary_credential 属性不能设置为 false。

  • Implemented and improved the file-based credentials cache for Linux, including enhanced token caching.

错误修复

  • 无。

版本 3.7.0（2025 年 4 月 14 日）

非公开预览版 (PrPr) 功能

在非公开预览版中添加了对 PAT（编程访问令牌）、OAuth 2.0 授权代码流、OAuth 2.0 客户端凭据流及 OAuth 令牌缓存的支持：

  • 对于 PAT：

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

  • 对于 OAuth 2.0 授权代码流：

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

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

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

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

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

  • 对于 OAuth 令牌缓存：

    • 需要将 UID（用户名）传递给驱动程序配置，并且 clientStoreTemporaryCredential 属性不能设置为 false。

免责声明：

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

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

  • 这些 PrPr 功能不受支持。但在 PrPr 期间，可以向产品和工程团队进行咨询。

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

新功能和更新

  • 将 curl 库 (libcurl) 从版本 8.10.1 更新到了 8.12.1。

错误修复

  • 启用了 Windows 的地址空间布局随机化 (ASLR) 安全编译器选项。

  • 修复了某些代码路径使用 INFO 级别记录整个 SQL 查询文本的问题。有关更多信息，请参阅 CVE-2025-46614 (https://community.snowflake.com/s/article/Snowflake-Connector-for-ODBC-Security-Advisory-CVE-2025-46614)。

版本 3.6.0（2025 年 3 月 8 日）

新功能和更新

  • 增加对区域 Google Cloud Storage 端点的支持。

错误修复

  • 修复了当 basic_string::_M_construct 为 null 或无效，或因 HOME 环境变量未设置而出现分段错误时，驱动程序崩溃的问题。

  • 修复了 MacOS 安全存储辅助程序的一个问题。

  • 修复了在使用 OKTA 身份验证时小写 URL 的问题。

  • 修复了 test 按钮的日志记录问题。

  • 修复了查询响应忽略长度的问题。

  • 修复了 HTTP 日期表头格式因区域设置而异的问题。

语言: 中文