2024 年 .NET Driver 版本说明

本文包含 .NET Driver 的版本说明，包括以下内容（如果适用）：

  • 行为变更

  • 新功能

  • 面向客户的错误修复

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

版本 3.1.0（2024 年 3 月 27 日）

新功能和改进

  • 添加了对运行异步查询的支持。

错误修复

  • 改进了从 Okta 身份验证器抛出的异常。

  • 修复了验证极短（1-2 个字符）账户名称的问题。

  • 修复了有关从包含引用内容的连接字符串（如 "WAREHOUSE=\"two words\""）中检索 WAREHOUSE 属性的问题。

版本 3.0.0（2024 年 2 月 29 日）

BCR （行为变更版本）变更

  • 为了提高安全性，驱动程序不再搜索临时目录来进行简单的日志记录配置。此外，驱动程序现在要求 Unix 系统中的日志记录配置文件对文件权限进行限制，只允许文件所有者修改文件（如 chmod 0600、chmod 0644）。

  • 对于 PUT/GET 故障，驱动程序现在抛出一个带有 QueryID 的 SnowflakeDbException。此前，驱动程序返回不同类型的异常，如 FileNotFound 和 DirectoryNotFound。如果您的应用程序检查出了这些异常中的任何一个，则必须更新代码，仅处理 PUT/GET 故障的 SnowflakeDbException。

  • 驱动程序不再支持块解析器/下载器的旧版本，如 V1 和 V2。作为升级到 V3 版本的一部分，驱动程序不再支持 SFConfiguration.UseV2JsonParser 或 SFConfiguration.UseV2ChunkDownloader 配置选项。如果您使用了类似于下面的命令，则应将其移除：

    • SFConfiguration.Instance().ChunkParserVersion = 1; 或 SFConfiguration.Instance().ChunkParserVersion = 2;

    • SFConfiguration.Instance().ChunkDownloaderVersion = 1; 或 SFConfiguration.Instance().ChunkDownloaderVersion = 2;

    • SFConfiguration.Instance().UseV2JsonParser

    • SFConfiguration.Instance().UseV2ChunkDownloader

新功能和改进

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

错误修复

  • 改进了简单日志记录功能的安全性，包括：

    • 使用更可靠的方式来确定在搜索客户端配置文件时，使用哪个驱动程序目录。

    • 不再使用临时目录进行配置搜索。

    • 在 Unix 下强制执行额外的文件权限检查，以提高安全性。

    • 添加更为详细的日志记录。

  • 修复了 SSO/SAML 端点的 Okta 重试问题。

  • 为不执行文本的命令添加了快速失败。

  • 修复了 PUT/GET 执行失败时抛出的异常，以尽可能包含 QueryId。

  • 将 Portable.BouncyCastle 库替换为 BouncyCastle.Cryptography。

版本 2.2.0（2024 年 1 月 17 日）

BCR （行为变更版本）变更

  • 从版本 2.2.0 开始，.NET 驱动程序在根据账户名构造主机名时，会自动将账户名中的下划线 (_) 替换为连字符 (-)。此更改影响账户名包含下划线的 PrivateLink 客户。在这种情况下，必须通过将 allowUnderscoresInHost 设置为 true 来替换默认值。您可以在 ConnectionString 中设置 allowUnderscoresInHost=true，来替换此行为。

    做出此更改是为了修复在通过公共链接与账户名称中含有下划线的 Snowflake 账户连接时出现的 DNS 解析错误。

新功能和更新

  • 改进了 Arrow 性能。

  • 在根据账户名构造主机名时，自动将账户名中的下划线 (_) 替换为连字符 (-)。

  • 添加了 allowUnderscoresInHost 配置参数，允许在构造的主机名中保留账户名中的下划线 (_)。此参数使您可以替换与此版本关联的行为变更。

错误修复

  • 为了修复连接超时的问题，驱动程序现在会在连接时异步关闭过期会话。

语言: 中文