2026 年 .NET Driver 版本说明

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

  • 行为变更

  • 新功能

  • 面向客户的错误修复

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

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

版本 5.5.0(2026 年 4 月 13 日)

新功能和改进

  • 在 Snowpark Container Services (SPCS) 容器中运行时,登录请求的驱动程序现在包括 SPCS_TOKEN`(通过 :codenowrap:`SNOWFLAKE_RUNNING_INSIDE_SPCS 环境变量检测到)。

  • 具有云平台和环境检测功能的扩展登录请求遥测(AWS Lambda、EC2、AzureVM/Functions、GCE/Cloud Run、GitHub 操作)。检测在启动时后台运行一次,超时时间为 200 毫秒。您可以通过设置 SNOWFLAKE_DISABLE_PLATFORM_DETECTION 环境变量来禁用此功能。

  • authenticator=WORKLOAD_IDENTITY 添加了 workloadIdentityImpersonationPath 连接参数,该参数允许工作负载通过传递服务账户模拟以不同的身份进行身份验证。

  • 添加了 HonorSessionTimezone 连接参数(默认值为 false)。设置为 true 时,TIMESTAMP_LTZ 值遵循会话 TIMEZONE 参数(设置使用 ALTER SESSION SET TIMEZONE)而不遵循本地计算机时区。这将成为未来主要版本中的默认行为。

错误修复

  • 修复了关闭空闲会话失败时未将其从连接池中逐出的问题。

  • 修复了在查询执行期间接收到 HTTP 401 的会话返回到连接池的问题。

  • 修复了在 CancellationToken 已取消时 GetResultsFromQueryIdAsync 不会中止服务器上查询的问题。以前,只有客户端轮询会停止,而查询会继续在 Snowflake 上运行。

  • 修复了服务器为加密暂存区返回预签名 URLs 时,Azure GET (下载) 操作错误报告 UPLOADED 结果状态而非 DOWNLOADED 的问题。

  • 修复了在失败的查询响应中,服务器返回 queryContext 时查询上下文缓存未更新的问题。

  • 改进了 CRL 颁发者验证:现在使用 DER 编码比较颁发者名称(避免字符串形式不匹配,例如 S=ST= ),此外,CRL 的授权密钥标识符将根据发放验证 CA 的主题密钥标识符进行验证(当两个扩展名都存在时)。

版本 5.4.1(2026 年 2 月 17 日)

新功能和改进

  • 扩展了登录请求遥测功能,增加了从 /etc/os-release. 解析的 Linux 发行版详细信息。

错误修复

  • 修复了 Arrow 结果分块处理中的 IndexOutOfRangeException:通过在 ExtractCell() 中增加重试状态清理、批次完整性校验以及防御性边界检查实现了此项修复。

  • 修复了以 Arrow 结果格式读取小数位数大于 9 的 NUMBER/DECIMAL 列时的 IndexOutOfRangeException

版本 5.4.0(2026 年 2 月 5 日)

新功能和改进

  • 添加了对 Red Hat Enterprise Linux (RHEL) 9 的支持。

  • 添加了对 DECFLOAT 数据类型的支持(作为字符串返回,以保持完整精度)。

错误修复

  • 修复了在 Snowflake 后端返回空批次时,Arrow 结果处理中出现的 IndexOutOfRangeException

版本 5.3.0(2026 年 1 月 7 日)

新功能和改进

  • 引入了用于扩展遥测的共享库,以识别原生 Rust 扩展并为其准备测试平台。

错误修复

  • 无。