2024 年 JDBC Driver 版本说明¶

添加了对 ZSTD 解压的支持。

将公共领域 IO 依赖项升级到了版本 2.17.0。

修复了会影响 JDBC 驱动程序的问题：当 CLIENT_ENCRYPTION_KEY_SIZE 参数设置为 256 位（而不是默认 128 位）时，推送到 Azure 和 GCP 暂存区的文件在没有客户端加密的情况下上传。有关更多信息，请参阅 Snowflake JDBC 安全公告 (https://github.com/snowflakedb/snowflake-jdbc/security/advisories/GHSA-f686-hw9c-xw9c)。

将 protobuf-java 依赖项更新到了版本 3.25.5。

添加了针对取消的查询原因的日志消息。

更新了 Bouncy Castle 依赖项。

添加了指向 SSL 异常消息的故障排除指南链接。

统一了结构化类型的字符串表示方法。

修复了从 git 存储库下载流的问题。

修复了连接超时参数的问题。

修复了 Arrow 日志记录的问题。

将自定义云存储标头元数据处理更改为不区分大小写。

添加了对禁用连接缓存的支持。

添加了 PRIVATE_KEY_BASE64 连接参数，以支持 base64 编码的私钥。

添加了以下连接属性以支持设置超时：

• HTTP_CLIENT_CONNECTION_TIMEOUT 和 HTTP_CLIENT_SOCKET_TIMEOUT 连接属性。

• BROWSER_RESPONSE_TIMEOUT 连接属性，以指定浏览器超时。

升级了以下依赖项：

• Arrow 升级到了版本 17.0.0

• threeten-bp 升级到了版本 1.6.9

修复了以下问题：getDate 方法缺少预期参数。

修复了与 LoggerFactory 相关的 class not found 问题。

netty 库更新到了版本 4.1.111.Final。

在 SnowflakeBasicDataSource 中添加了缺失的属性设置器。

添加了以下连接参数，以支持向后兼容处理时区：

• JDBC_DEFAULT_FORMAT_DATE_WITH_TIMEZONE 确定是否使用格式化程序先前的硬编码值（默认值：true）。

• JDBC_GET_DATE_USE_NULL_TIMEZONE 确定是否对 getDate 方法使用先前为空的时区值（默认值：true）。

为 Snowflake 主机选择了一个顶级域名。

为所有失败的语句设置最后一个查询 ID。

修复了以下问题：重试退避时间可能超出最小值和最大值范围。

修复了在转换 OBJECT 列中的嵌套字段元数据时出现的问题。

修复了以下问题：在使用 getString 或 getDate 方法时，日期文件返回了错误的日期。

添加了针对令牌文件的用户权限检查。

改进了日志记录。

在列元数据中公开了向量维度。

在向量列上添加了对 getObject 的支持。

添加了对从文件读取连接信息的支持。

添加了对 Java 版本 21 的支持。

添加了对元数据中动态 Max LOB 大小的支持。

改进了日志记录配置。

添加了 JDBC 连接诊断模式。

修复了批量插入大量列时插入和读取时间戳不对称的问题。

修复了在 JSON 和 ARROW 结果集之间返回不一致的 timestamps_ltz 的问题。

修复了以下问题：驱动程序无法对不同模式中未找到的文件进行文件模式扩展。

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

修复了根据区域名称选择 S3 区域性 URL 域的问题。

修复了解析客户端配置时与 Windows 中嵌套路径相关的问题。

修复了以下问题：针对 JSON 中数组的方法 getObject 在 3.15.1 和 3.16.0 版本中运行不正确。

修复了 MapVector 的类型转换问题。

添加了对结构化类型的支持。

添加了对向量类型的支持。

改进了对加密私钥的支持。

更新了安全策略说明。

修复了原生 OKTA 重试逻辑的问题。

修复了不支持的保留关键字的问题。

修复了 GET 查询元数据请求的重试次数问题。

添加了对缺失的代理和用户密码 JVM 参数的支持：http.proxyUser、http.proxyPassword、https.proxyUser、https.proxyPassword。

将 nimbus-jose-jwt 依赖项升级到版本 9.37.3。

进行 Shading 处理时将公共后缀列表移至内部包。

修复了忽略默认 GCS 凭据的问题。

修复了以 ARROW 格式返回十进制或整型值的问题。

修复了以下问题：驱动程序在调用 SFAsyncResultSet.next 时返回 java.util.ConcurrentModificationException。

修复了 Windows 上因嵌套文件路径而导致的 InvalidPathException 问题。

为内部 API 添加了标记注释。

添加了两个新的 Java 属性，即 net.snowflake.jdbc.http_client_connection_timeout_in_ms 和 net.snowflake.jdbc.http_client_socket_timeout_in_ms，允许您配置连接和套接字超时。

添加了新的 enablePatternSearch 连接参数，用于启用或禁用不应将其参数用作模式的 getCrossReference、getExportedKeys、getImportedKeys 和 getPrimaryKeys 元数据操作的模式搜索。默认：true。

修复了与多版本 jar 条目相关的问题。

在 HttpClientSettingsKey 中将 com.amazonaws.Protocol 的依赖项设置了可选项。

弃用了 com.snowflake.client.jdbc.SnowflakeDriver。

修复了解析大型响应（大于 16MB）时出现的问题。

将 JDBC 规范更新到版本 4.2。

添加了对 AIX 7.2 的支持。

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

将 grpc-netty-shaded 依赖项更新为了 1.60.0。

创建了轻量级 jar 作为单独的 maven 工件 snowflake-jdbc-thin （JDBC 轻量级 jar 是实验功能）。

在 toString() 中实施了 SnowflakePreparedStatementV1。

添加了 getQueryStatusV2，替代已弃用的 getQueryStatus。

为失败的语句设置了最后一次查询 ID。

修复了使用无连接模式时的 OOB 遥测初始化问题。

修复了使用无连接模式时正确处理 GCP 令牌到期的问题。

修复了 AIX 上的 arrow 格式问题。