2025 年 Go Snowflake Driver 版本说明¶

新功能和更新¶

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

  • 添加了 WorkloadIdentityProvider 连接参数。

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

• Added support for CRL (certificate revocation list).

  CRL 指定了某个 CA 明确吊销的证书。此驱动程序现在可使用 CRL 或 OCSP 来验证 TLS 证书。

  默认禁用 CRL。请参阅 CRL 本 KB 文章中的启用指南 (https://community.snowflake.com/s/article/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))，并在生产使用前以建议模式进行测试。

• 在 OAuth 流程中新增对可选择的单次使用刷新令牌的支持。

• 实现了 Connectivity Diagnostic Tool。

• 在连接和心跳模块生成的日志中新增了会话 ID。

• 新增 RegisterTLSConfig 函数，允许您传入自定义的 TLSConfig 供驱动程序使用。

• 移除了 OCSP 检查对静态根 CAs 列表的依赖。现在，使用默认的根 CAs 列表。

错误修复¶

• 修复了在读取结构化类型时错误消息未显示的问题。

• 修复了 Arrow 批处理示例中的内存泄漏问题。

• 修复了查询取消相关的问题。

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

• Fixed an issue with ignoring the maximum retry count when the timeout is not set.

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

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

免责声明：

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

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

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

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

新功能和更新¶

• 添加了对蛇形命名法连接参数的支持。

• 优化了执行 PUT 命令期间的内存消耗。

错误修复¶

• 修复了 configuration.toml 文件权限处理的问题。

新功能和更新¶

• 添加了对 OpenTelemetry 上下文传播到 GS 的支持。

• 添加了对 OAuth 授权代码流中默认客户端凭据的支持。

• 将 OCSP 初始化移至第一次 HTTPS 调用。

错误修复¶

• 将针对 NUMBERs 的扫描类型和实际返回的类型保持一致。

• 修复了在原始上下文仍然有效的情况下，nil 发生内部超时（例如对于云提供商调用）时取消引用的问题。

• 修复了在超时或取消上下文争用时，nil 取消引用的问题。

• 修复了从不返回错误的加密错误。

• 修复了将 smkId 向下转换为 int 的问题，该问题会导致极大的暂存区发生解密问题。

• 修复了对 GCP 上虚拟式域的支持。

• 修复了安全存储锁目录所有者的验证问题。

新功能和更新¶

• 实现了对 OAuth2 授权码和客户端凭据流的支持。

• 添加了对 PAT（编程式访问令牌）的支持：

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

• 增加了对 GCP 暂存区虚拟端点的支持。

错误修复¶

• 修复了启用更高精度时 NUMBER 列的扫描类型问题。

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

• 实现了对 OAuth2 授权码和客户端凭据流的支持。

免责声明：

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

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

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

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

新功能和更新¶

• 无。

错误修复¶

• 修复了每次重试请求时重新加密文件的问题。

• 修复了检查 Easy Logging 配置文件访问权限时的 Time-of-check Time-of-use (TOCTOU) 争用条件。有关更多信息，请参阅 CVE-2025-46327 (https://github.com/snowflakedb/gosnowflake/security/advisories/GHSA-6jgm-j7h2-2fqg)。

新功能和更新¶

• 将 JWT 库版本从 5.2.1 提升到 5.2.2。

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

错误修复¶

• 修正了查询以换行开头时的 PUT/GET 处理方法。

• 为证书链验证添加了更多日志记录。

• 只有在 POST 请求的响应形式不当时，才会退回到 OCSP GET 请求。

• 修正了与未清除 OCSP 缓存有关的内存泄漏问题。

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

在非公开预览版中添加了对 PAT（程序化访问令牌）的支持。

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

免责声明：

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

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

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

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

新功能和更新¶

• 删除了对 Go 1.21 的支持，并添加了对 Go 1.24 的支持。

• Arrow 升级到了 v18。

• 添加了 JWT 声明的日志。

错误修复¶

• 修复了 HTTP 重试的错误消息。

新功能和更新¶

• 现在，驱动程序将 UUID 作为 varchars 处理。

• 在绑定参数时，驱动程序支持 driver.Valuer/fmt.Stringer 接口。

• 驱动程序会检测响应是否基于 JSON，并在启用 Arrow 批处理模式时运行常规块下载器，以便以行的形式获取响应。

• 为云提供商调用添加了超时配置。

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

• 修复了少量文档格式问题。

• 在向 GCP 调用 HEAD 请求时添加了重试功能。

• 将 x/crypto 库升级到了版本 v0.31.0。

错误修复¶

• 修复了处理 Arrow 响应时导致 64 字节内存泄漏的问题。

• 修复了使用 us-west-2 时忽略区域的问题。

• 在尝试从空私钥生成 JWT 前，添加了对空私钥的检查。

• 驱动程序使用正确的传输方式进行云提供商调用。

• 禁用 OCSP 时，驱动程序不再为云提供商执行 OCSP 调用。