2024 年 Go Snowflake Driver 版本说明

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

  • 行为变更

  • 新功能

  • 面向客户的错误修复

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

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

版本 1.12.0(2024 年 10 月 30 日)

新功能和更新

  • 添加了对 Golang 1.23 的支持,删除了对 Golang 1.20 的支持。

  • 添加了对使用 connections.toml 配置连接的支持。

  • 将 logrus 升级到了版本 1.9.3。

  • 扩展了使用 QueryArrowStream 查询时的日志记录。

错误修复

  • 修复了会话续订时出现的 requestIDs 和 requestGUIDs 重复问题。

  • 修复了 Azure 的代理配置。

  • 移除了 *.okta.com 原生 Okta 身份验证器 URL 限制。

  • 修复了 filestransfer 示例中因文件路径错误而失败的问题

版本 1.11.2(2024 年 10 月 3 日)

新功能和更新

  • GetFileToStream 变更为了 SnowfalkeFileTranserOptions struct 的导出成员,以便 GET 操作可以使用流读取文件,从而减少内存使用量。

错误修复

  • 修复了从 S3 桶获取加速配置时的错误处理。

版本 1.11.1(2024 年 8 月 29 日)

新功能和更新

  • 添加了对使用 GET 命令时将文件下载到内存流的支持。

  • snowflakeFileTransferAgent 添加了上下文传播,支持取消文件传输过程。

错误修复

  • 删除了 snowflakeConn 中的上下文传播,仅用于拨号。

  • 防止 Golang 切片在 arrayToString 方法中发生死机。

  • 防止取消下载时 decodeChunk 方法发生死机。

版本 1.11.0(2024 年 7 月 31 日)

新功能和更新

  • 添加了对 Go 1.22 的支持并删除了对 Go 1.19 的支持。

  • 针对中国部署调整了驱动程序配置。

  • 添加了在查询中绑定结构化类型的功能。

  • 添加了对启用 MFA 令牌缓存的情况下使用密码的支持。

  • 添加了对在 DSN 中设置会话变量的支持。

  • 提供了一个更简单的解决方案,使用标签来定义结构化对象。

  • 提供了一种机制,可以将每个 goroutine 封装在自定义代码中。

错误修复

  • 修复了与执行长时间运行查询时处理会话过期有关的问题。

  • 修复了禁用 OCSP 缓存时 OCSP 失败的问题。

  • 修复了与读取包含小于 64b 的整数列的 arrow 批次有关的问题。

版本 1.10.1(2024 年 5 月 29 日)

新功能和更新

  • 升级了 AWS SDK 依赖关系。

  • 在日志中添加了自动密码遮掩功能。

  • 添加了 DisableSamlURLCheck 参数以禁用 SAML URL 检查。

  • 添加了对绑定半结构化类型的支持。

  • 减少了 OCSP 的重试次数。

  • 添加了 OcspMaxRetryCountOcspResponderTimeout 变量,用于分别定义 OCSP 最大重试次数和超时时间。

错误修复

  • 修复了与 Arrow 批处理模式下的公开对象有关的问题。

  • 修复了使用密钥对身份验证时与提取账户名称有关的问题。

版本 1.10.0(2024 年 5 月 8 日)

新功能和更新

  • 实现了对结构化类型(结构化对象、数组和地图)的支持。

  • 添加了用于在启动期间跳过驱动程序注册的选项。

  • 添加了 SECURITY.md 文件,以便客户可以查看 Snowflake 的安全策略。

  • 添加了自定义记录器字段的设置功能。

错误修复

  • 修复了使用异步模式时两次关闭错误通道的问题。

  • 修复了访问临时凭据时的竞态条件。

版本 1.9.0(2024 年 3 月 28 日)

新功能和更新

  • 升级到了 Arrow 版本 15。

  • 添加了对 Arrow 批处理模式下 WithHigherPrecision 上下文的支持。

  • 添加了从 Snowflake 格式到 Golang 格式的日期和时间转换器。

  • 添加了替换 Arrow 响应中 UTF-8 字符的上下文。

错误修复

  • 修复了传输文件时处理不可用的 Amazon S3 加速配置的问题。

  • 修复了 Arrow 模式下大数除法的问题。

  • 修复了日志记录初始化期间的数据竞速问题。

  • 修复了响应中缺少第一批结果时无法下载结果的问题。

  • 修复了未经身份验证的请求的退避重试期问题。

  • 修复了程序结束时僵死 DBus 进程未终止的问题。

版本 1.8.0(2024 年 2 月 21 日)

新功能和更新

  • 添加了对多种 SAML 集成的支持。

  • 添加了对 Arrow 批处理时间戳的秒、毫秒和微秒精度的支持。

错误修复

  • 通过在提取结果时检查 queryInProgressAsyncCode 响应代码,修复了 WithFetchResultByID 问题。

  • 修复了收到 HTTP 429 错误时 OKTA 身份验证失败的问题。

  • 修复了驱动程序错误地为空 Arrow 批处理返回错误的问题。

版本 1.7.2(2024 年 1 月 17 日)

新功能和更新

  • 添加了对 Go 版本 1.21 的支持。

  • arrow 库升级到了版本 v14。

  • 更新了 jose2gocrypto 依赖关系。

  • 允许客户端通过上下文设置 QUERY_TAG 参数。

  • 所有云提供商都使用相同的标准 http.Transport 进行了标准化。

  • 添加了一个示例,说明如何使用变量绑定将数据插入 VARIANT 和 OBJECT 列。

错误修复

  • 修复了以下与错误处理相关的问题:

    • 现在,当发生文件上传错误时,驱动程序会传播错误。

    • 现在,驱动程序会传播区块下载期间发生的错误。

    • 当第一个块下载出现错误时,驱动程序不会开始块下载。

  • 修复了启用 arrow_batches 模式时驱动程序尝试读取空块的问题。

  • 移除了 HTTP 400 和 405 状态的重试次数。

  • 修复了在 S3 HEAD 调用期间出现意外错误的问题。

  • 修复了文档中的 GET 示例。

语言: 中文