2025 年 ODBC Driver 版本说明

本文包含 ODBC Driver 的版本说明,包括以下内容(如果适用):

  • 行为变更

  • 新功能

  • 面向客户的错误修复

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

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

Version 3.13.0 (November 20, 2025)

新功能和更新

  • Added support for Decfloat types.

  • Support cross-signed chains during OCSP check.

  • Implemented a new CRL (Certificate Revocation List) checking mechanism.

    Enabling CRLs improves security by checking for revoked certificates during the TLS handshake process. For more information, see the Replacing OCSP with CRL as the method of certificate revocation checking (https://community.snowflake.com/s/article/Replacing-OCSP-with-CRL-as-the-method-of-certificate-revocation-checking) Knowledge Base article.

    This feature is disabled by default. For information on enabling this feature, see Certificate revocation list (CRL) options. Snowflake recommends that you test this feature before enabling it in production.

错误修复

  • Removed the trailing null termination character from the JWT header and payload.

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_idoauth_client_secret OAUTH 参数添加了 LOCAL_APPLICATION 默认值。

  • 使用密钥对身份验证参数 PRIV_KEY_FILEPRIV_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_idoauth_client_secretoauth_authorization_urloauth_token_request_urloauth_scope DSN 参数。

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

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

      • 添加了 oauth_client_idoauth_client_secretoauth_token_request_urloauth_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_idoauth_client_secretoauth_authorization_urloauth_token_request_urloauth_scope DSN 参数。

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

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

    • 添加了 oauth_client_idoauth_client_secretoauth_token_request_urloauth_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_constructnull 或无效,或因 HOME 环境变量未设置而出现分段错误时,驱动程序崩溃的问题。

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

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

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

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

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

语言: 中文