2025 年 Go Snowflake Driver 版本说明¶

新功能和更新¶

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

• 改进了 Linux 下基于文件的凭据缓存。

错误修复¶

• 修正了查询以换行开头时的 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 调用。