2025 年 ODBC Driver 版本说明¶

新功能和更新¶

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

  • 添加了 workload_identity_provider 连接参数。

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

• Added the following configuration parameters:

  • DisableTelemetry 以禁用遥测。

  • SSLVersionMax 以指定最高 SSL 版本。

• 添加了 PRIV_KEY_BASE64 和 PRIV_KEY_PWD 连接参数，允许传递经过 base64 编码的私钥。

错误修复¶

• 修复了带内遥测事件处理程序的问题，以正确重置事件。

• 修复了用于通过 OKTA 进行身份验证的 HTTP 标头。

• 在 OAuth 授权过程中从默认 RedirectUri 中移除了尾斜杠。

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

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

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

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

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

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

新功能和更新¶

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

错误修复¶

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

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

非公开预览版 (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 验证问题。

新功能和更新¶

• 添加了对 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。

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

错误修复¶

• 无。

非公开预览版 (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)。

新功能和更新¶

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

错误修复¶

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

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

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

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

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

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