2023 年 Node.js Driver 版本说明¶

增强了通用和代理用例的可观测性。

更新了以下库：

• glob 更新到版本 9.0.0。

• https-proxy-agent 更新到版本 7.0.2。

无。

添加了对 Node.js 版本 20 的支持。

现在，如果连接处于续订或连接状态，则认为它们有效。

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

添加了 retryTimeout、sfRetryStartingSleepTime 和 sfRetryMaxLoginRetries 连接参数，以管理失败的连接请求的重试频率。retryTimeout 的默认值为 300。

添加了 account 参数验证。

更新了以下库：

• axios 版本更新至 1.6.0

• mocha 版本更新至 10.2.0

• bignumber.js 版本更新至 9.1.2

• 向 peerDependency 添加了 asn1.js，并将 @techteamer/ocsp 版本更新至 1.0.1

修复了 sqlText 在由用户指定时被覆盖的问题。

修复了缓存所有类型的 HTTPS 代理的问题。

修复了与使用 axios httpclient 进行 Okta 身份验证相关的问题。

修复了使用代理进行外部浏览器 SSO 身份验证的问题。

修正了 Okta 身份验证的响应处理。

在 Node.js 驱动程序中取消了对 Node.js 库版本 12 的支持。Node.js 不再正式支持其库的版本 12。 Snowflake 鼓励使用 Node.js 版本 12 环境的所有人升级到 Node.js 版本 18。

添加了对混合事务和分析处理的支持：

• 在查询请求的重试中添加了重试上下文。

• 添加了查询上下文缓存。

更新了以下库：

• 将 urlib2 库替换为 axios。

• 将 aws-sdk 升级到版本 v3。

• 将 uuid 升级到版本 8。

现在，默认 JSON 解析器从新的 Function 对象返回结果。

修复了 moment.js 库在日志消息中错误填充时间的毫秒位置的问题。

修复了在 Windows 和 Azure 环境中从暂存区获取文件的问题。

修复了外部浏览器身份验证错误地要求用户名和密码的问题。

添加了 connection.isValidAsync() 函数，以确定连接是否已建立并且可用。

修复了在多文件下载过程中某些暂存区文件未正确下载的问题。

修改了 fetchAsString 错误消息，以将“Buffer”作为接受的类型包括在内。

修复了暂存区绑定的性能问题。

修复了 connection.execute() 在绑定模式下不返回语句的问题。

修正了 connection.heartbeatAsync()，以使用 connection.heartbeat() 函数所用的同一端点，而不是使用 SELECT 1 进行查询。

添加了对使用自定义配置来初始化 JSON 解析器和 XmlParser 的支持。

排除了易受攻击的 vm2 传递依赖性。

添加了 browserActionTimeout 连接参数，用于修复外部浏览器中身份验证的问题。

修复了私钥在密钥末尾包含新行的问题。

修复了与导入 uuid 库相关的问题。

移除了未使用的 qs 依赖项。

修复了 LargeResultSet 中的重试问题。

将 better-eval 包替换为 vm。

取消了对 OAuth 连接用户名的要求。

无。

添加了缺少的 bn 和 https-proxy-agent 依赖项。

修复了 econnreset 和 etimedout 错误代码不会重试连接的问题。

修正了使用 requestId 调用 connection.execute() 失败时返回的错误消息。

修正了在以下情况返回的错误消息：使用 OKTA 或外部浏览器身份验证器时，调用 connect() 失败。

修复了 maskedtxt 变量未定义错误。

修复了在使用 OAuth 身份验证器时多个连接发生的问题。

修复了在调用 connection.execute() 时 sqltext 中的额外空格导致错误的问题。

修复了以下问题：由于在睡眠计时器中使用了错误的值，导致重试连接失败。

添加了对用于 PUT/GET 的 GCS 访问令牌的支持。

添加了对 Okta Identity Engine (OIE) 登录的支持。

提升了使用 eval 函数解析 JSON 字符串时的安全性。

修复了从 VARIANT 列加载的 XML 数据的解析问题。

修复了 OCSP 缓存过期后未刷新的问题。

修复了在数组绑定上使用完整表路径可能导致应用程序崩溃的问题。

要解决与 Buffer() 弃用相关的弃用警告问题，请重新安装 snowflake-sdk。重新安装会将 formstream 库更新为最新版本（如 formstream 1.2.0），并解决此问题。

无。

现在，Node.js 驱动程序支持重试 HTTP 429 错误代码。

修复了 Node.js 驱动程序不会通过代理发送 OCSP 请求的问题。

修复了一个问题，即使用数组绑定提交的数据量超过数组绑定阈值时会出错。现在，驱动程序会为引入生成输出，而不是使 SQL 语句失败。

修复了以下问题：从版本 1.6.13 升级到更高版本后，错误地生成了“Bind variable ? not set”错误消息。

无。

修复了以下问题：尝试使用数组绑定插入大量数据时，插入查询会间歇性失败。

添加了批量执行 SQL 语句（多语句支持）的功能。

将 jsonwebtoken 库更新到版本 9.0.0。

通过发送心跳消息而不是选择调用来验证端点连接，提高了性能。

在日志消息中添加了 OCSP 打开失败的错误详细信息，并将日志级别从信息更改为警告。

添加了一项检查，以在设置缓存条目之前验证是否已初始化 OCSP 缓存。