2026年の Node.js Driver リリースノート

この記事には、 Node.js Driver のリリースノートが含まれています。また、該当する場合は以下が含まれます。

  • 動作の変更

  • 新機能

  • 顧客向けバグ修正

Snowflake は、 Node.js Driver の更新にセマンティックバージョニングを使用します。

ドキュメントについては、 Node.jsドライバー をご参照ください。

バージョン2.4.0(2026年4月7日)

新機能および更新

  • EXTERNALBROWSER 認証コールバックを受信するローカルサーバーのポートをカスタマイズする browserRedirectPort 接続オプションを追加しました。

  • fast-xml-parser 脆弱性に対処するために @aws-sdk/* 依存関係を更新しました。

  • サーバーが接続を閉じる前に古い接続を積極的に破棄する、30秒のアイドルソケットタイムアウトを使用して、キープアライブ HTTP エージェントを改善しました。これにより、ソケットのハングアップと ECONNRESET エラーを防ぎます。

バグ修正

  • EXTERNALBROWSER または OAUTH_AUTHORIZATION_CODE 認証方式を使用するときに、プールされた接続ごとにブラウザー認証を再プロンプトする接続プールを修正しました。最初の接続は認証を完了し、後続のプール接続を開始する前にトークンをキャッシュします。

  • 不正な形式のリクエストによってセッショントークンの更新が失敗し、期限切れのセッショントークンを更新する代わりに、長時間実行されている接続が切断されていた問題を修正しました。

  • 失敗したクエリでクエリコンテキストキャッシュが更新されず、後続のクエリが別の GS ノードにあるとキャッシュが古くなる可能性があった問題を修正しました。

バージョン2.3.6(2026年3月25日)

新機能および更新

  • :codenowrap:`connect()`でのすべての認証方式(外部ブラウザやOktaを含む)のサポートを追加しました。これにより、:codenowrap:`connectAsync()`の仕様と一致するようになります。

  • :codenowrap:`@google-cloud/storage`依存関係を削除しました。GCSの転送ではJSONAPIを直接使用するようになりました。:codenowrap:`forceGCPUseDownscopedCredential`接続オプションは、不要になったため削除されました。

  • デフォルトの:codenowrap:jsonColumnVariantParser`を更新しました。これにより、:codenowrap:`JSON.parse`をプライマリパーサーとして維持しつつ、JSONに準拠していないバリアント値(:codenowrap:`undefinedNaN、:codenowrap:`Infinity`など)を扱う際、evalベースの解析にフォールバックするようにし、2.3.5以前の動作を復元しました。

バグ修正

  • :codenowrap:`OAUTH_AUTHORIZATION_CODE`認証機能が:codenowrap:`openExternalBrowserCallback`接続オプションを優先しない問題を修正しました。

  • :file:`connections.toml`から構成をロードするランタイムの動作に合わせて、引数を受け入れないように:codenowrap:`createConnection()`および:codenowrap:`createPool()`の型を修正しました。

  • :codenowrap:`account`フィールドは:codenowrap:`accessUrl`または:codenowrap:`host`から派生させることが可能なため、:codenowrap:`ConnectionOptions`型においてオプションとなるように修正しました。

  • SSO URLリクエストがサーバー側エラーを返した際に、外部ブラウザSSO認証がクラッシュする問題を修正しました。

バージョン2.3.5(2026年3月17日)

新機能および更新

  • :codenowrap:`SF_SKIP_TOKEN_FILE_PERMISSIONS_VERIFICATION`環境変数を使用して、トークンファイルの権限チェックをスキップする機能を追加しました。

  • 2.xリリース以降、公式にサポートされる最小バージョンであるNode 18+をエンジンに追加しました。

  • :codenowrap:`login-request`テレメトリに:codenowrap:`PLATFORM`フィールドを追加しました。

  • 以前はカバーされていなかったクエリ実行パスに対するリクエストの再試行を追加しました。

  • :codenowrap:`statement.streamRows()`を介してクエリ結果をストリーミングするときにバッファされる行数を制御する:codenowrap:`rowStreamHighWaterMark`接続オプションを追加しました。

  • クエリ結果を、精度が低下するJavaScript数値に変換する際の警告を追加しました。

  • 引数なしで:codenowrap:`createConnection()`を介して:file:`connections.toml`をロードする場合におけるsnake_caseキーのサポートを追加しました。

  • snake_caseの接続キーをcamelCaseに変換する:codenowrap:`normalizeConnectionOptions()`ユーティリティをエクスポートしました。これにはキーのエイリアス設定や頭字語の上書き機能も含まれています。

  • :codenowrap:`login-request`テレメトリに :codenowrap:`LIBC_FAMILY`および:codenowrap:`LIBC_VERSION`フィールドを追加しました。

  • CRLファイルのダウンロード時に最大応答サイズ制限を適用する:codenowrap:`crlDownloadMaxSize`構成オプションを追加しました。

  • CRL検証のためのRSASSA-PSS署名検証サポートを追加しました。

  • OAuthが失敗した場合のエラーの詳細を改善しました。

  • デフォルトの:codenowrap:`jsonColumnVariantParser`を:codenowrap:`JSON.parse`に変更しました。

  • 古いLinuxディストリビューションとの幅広い互換性を確保するため、glibc 2.18をターゲットとするようにLinux GNU minicoreバイナリを更新しました。

バグ修正

  • バンドラーの使用時にOAuthがクラッシュする問題を修正しました。

  • 読み取り専用配列を許可するように:codenowrap:`Binds`のタイピングを修正しました。

  • 接続が完了する前に:codenowrap:`connectAsync()`メソッドが解決される問題を修正しました。

  • :codenowrap:`connect()`および:codenowrap:`connectAsync()`でオプションである必要があるコールバック引数の誤った処理を修正しました。

  • ユーザーが構成で誤ってアカウントとホストの両方を設定した場合に、無効なJWTが生成されるバグを修正しました。

  • Microsoft Identity Platform v2.0トークンのオプションパラメーターが含まれている場合にJSONメディアタイプの解析に失敗し、OAuthクライアント認証情報フローが失敗するバグを修正しました。

  • 正しい大文字と小文字である:codenowrap:`disableSamlURLCheck`を使用するように:codenowrap:`disableSamlUrlCheck`のタイピングを修正しました。

  • os.tmpdir()`にフォールバックすることで、ユーザーのホームディレクトリが構成されていない環境において:codenowrap:`getDefaultCacheDir() がクラッシュする問題を修正しました。

  • :codenowrap:`SF_OCSP_RESPONSE_CACHE_DIR`がOCSPキャッシュディレクトリとして直接使用されない問題を修正しました。

  • :codenowrap:`noProxy`および:codenowrap:`NO_PROXY`の処理に関するバグを修正しました。

    • :codenowrap:`.domain.com`ワイルドカード形式が宛先ホストと正しく一致していませんでした。

    • :codenowrap:`.`がリテラルのドットではなく、任意の文字として誤って一致していました。

    • 宛先の完全一致が必要であるにもかかわらず、部分的な文字列が誤って一致していました。

  • 失敗をデバッグレベルではなく警告レベルでログに記録するように、CRL ADVISORYモードを修正しました。

  • キャッシュされたアクセストークンの有効期限が切れた際に、更新されたアクセストークンを使用しないOAuth認証コードの再認証を修正しました。

  • IDPが新しいトークンを返さない場合に、OAuth認証コードの更新トークンがキャッシュから削除される問題を修正しました。

  • サーバーが不正な形式のクエリ応答を返す場合に発生する未処理のプロミス拒否を修正しました。

バージョン2.3.4(2026年2月9日)

新機能および更新

  • PUT 操作中のメモリ使用量を削減しました。

  • APPLICATION_PATHlogin-request テレメトリーに追加しました。

  • /etc/os-release から解析されたLinuxディストリビューションの詳細を login-request テレメトリーに追加しました。

  • axiosをバージョン1.13.4に更新し、axiosインターセプターのバグに対処しました。

  • その他の依存関係を最新のマイナーバージョンに更新しました。

バグ修正

  • HTTP リクエスト全体の一貫性のない再試行動作を修正し、回復可能なすべての障害が適切に再試行されることを確認しました。

  • ` ロール ` および oauthScope が接続構成から欠落している場合に無効なoauthスコープを修正しました。

  • 接続構成から login-request テレメトリーに渡されていない APPLICATION フィールドを修正しました。

  • :codenowrap:` ミニコア ` モジュールが原因で発生したバンドルのビルドエラーを修正しました。