2025年の JDBC Driver リリースノート

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

  • 動作の変更

  • 新機能

  • 顧客向けバグ修正

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

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

バージョン3.18.1(2025年6月5日)

新機能および更新

  • なし。

バグ修正

  • トラストマネージャーのデフォルトのJVMアルゴリズムでトラストマネージャーを初期化する際の問題を修正しました。

バージョン3.17.1(2025年6月5日)

新機能および更新

  • なし。

バグ修正

  • トラストマネージャーのデフォルトのJVMアルゴリズムでトラストマネージャーを初期化する際の問題を修正しました。

バージョン3.21.1(2025年6月4日)

新機能および更新

  • なし。

バグ修正

  • トラストマネージャーのデフォルトのJVMアルゴリズムでトラストマネージャーを初期化する際の問題を修正しました。

バージョン3.20.1(2025年6月4日)

新機能および更新

  • なし。

バグ修正

  • トラストマネージャーのデフォルトのJVMアルゴリズムでトラストマネージャーを初期化する際の問題を修正しました。

バージョン3.22.1(2025年6月3日)

新機能および更新

  • なし。

バグ修正

  • トラストマネージャーのデフォルトのJVMアルゴリズムでトラストマネージャーを初期化する際の問題を修正しました。

バージョン3.24.2(2025年5月31日)

新機能および更新

  • なし。

バグ修正

  • トラストマネージャーのデフォルトのJVMアルゴリズムでトラストマネージャーを初期化する際の問題を修正しました。

バージョン3.24.1(2025年5月28日)

新機能および更新

  • codenowrap:HttpHeadersCustomizer インターフェイスを追加し、Snowflake JDBCドライバーによって開始される様々なリクエストにカスタムのHTTPヘッダをインジェクションする柔軟な方法を提供します。

  • codenowrap:clientId および clientSecret OAUTH パラメーターに LOCAL_APPLICATION のデフォルトを追加しました。

バグ修正

  • codenowrap:BindUploader を使って挿入した場合に、04.10.1582(グレゴリオ改正)より前のタイムスタンプを扱っていた問題を修正しました。

  • NPEファイルがアクセスできない場合のキャッシュファイルへの書き込み処理を修正しました。

  • AWSのWorkflow Identity Federationリクエスト署名を修正しました。

バージョン3.24.0(2025年4月30日)

プライベートプレビュー(PrPr)の特長

AWS、Azure、GCP、KubernetesプラットフォームにおけるWorkflow Identity Federationのサポートを追加しました。

免責事項:

  • この機能にアクセスするには、環境変数 SF_ENABLE_EXPERIMENTAL_AUTHENTICATIONtrue に設定する必要があります。

  • この機能は本番用以外のデータでのみ使用してください。

  • このPrPr機能はサポート対象外です。ただし、PrPrの段階での製品チームとエンジニアリングチームによる対応は可能です。

  • 参加方法およびドキュメントについては、担当のアカウントチームまでご連絡ください。

新機能および更新

  • PAT、OAuth 2.0認証コードフロー、OAuth 2.0クライアント認証情報フロー、OAuthトークンキャッシュのサポートを追加しました。

    • PAT: パラメーター認証方式に PROGRAMMATIC_ACCESS_TOKEN パラメーターを追加しました。

    • OAuth 2.0 認証コードのフロー:

      • codenowrap:oauthClientIdoauthClientSecretoauthAuthorizationUrloauthTokenRequestUrloauthScope のパラメーターを追加しました。

      • パラメーター認証方式に OAUTH_AUTHORIZATION_CODE パラメーターを追加しました。

    • OAuth 2.0クライアント認証フロー:

      • codenowrap:oauthClientIdoauthClientSecretoauthTokenRequestUrloauthScope パラメーターを追加しました。

      • パラメーター認証方式に OAUTH_CLIENT_CREDENTIALS パラメーターを追加しました。

    • OAuth トークンキャッシュ: ドライバー設定にユーザー名を渡す必要があり、 clientStoreTemporaryCredential プロパティを false には設定できません。

  • codenowrap:joda-time および google-http-client ライブラリの依存関係を削除しました。

バグ修正

  • プロキシ使用時のOCSPキャッシュサーバーURLを修正しました。

  • TIMESTAMP_LTZ タイプに対するバインディング実行が、他の日付時刻タイプに対して不正なバインディングを引き起こす問題を修正しました。

  • codenowrap:BindUploader で挿入する際に、04.10.1582(グレゴリオ改正)より前の日付の処理を修正しました。

  • codenowrap:CLIENT_TREAT_TIME_AS_WALL_CLOCK_TIME パラメーターを追加することで、TIMEタイプを壁時計の時間として扱うように修正しました。

バージョン3.23.2(2025年4月3日)

新機能および更新

  • なし

バグ修正

  • キャッシュフォルダにアクセスできない場合に発生していたNULLポインタ例外を修正しました。

バージョン3.23.1(2025年3月13日)

新機能および更新

  • なし

バグ修正

  • nimbusdsライブラリの依存関係バージョン宣言の欠落を修正しました。

  • Windows環境でキャッシュに使用するファイルを作成する際の問題を修正しました。

  • GET/PUTコマンドの実行中にターゲットステージのクライアント側暗号化マスターキーがローカルにログされた場合に、デバッグレベルでログが記録される問題を修正しました。キー自体は、いずれの機密データへのアクセスを許可するものでもありません。詳細は CVE-2025-27496 をご覧ください。

  • ストレージとの通信時にSnowflake認証情報よりもGCS認証情報を優先する問題を修正しました。パラメーター disableGcsDefaultCredentials のデフォルト値を true に変更しました。

  • OKTAを使用した認証プロセスで使用されるリトライメカニズムを修正しました。

バージョン3.23.0(2025年2月27日)

プライベートプレビュー(PrPr)の特長

PAT、OAuth 2.0認証コードフロー、OAuth 2.0クライアント認証フロー、OAuthトークンのキャッシュのサポートをプライベートプレビューに追加しました。

  • PAT: パラメーター認証方式に PROGRAMMATIC_ACCESS_TOKEN パラメーターを追加しました。

  • OAuth 2.0 認証コードのフロー:

    • codenowrap:oauthClientIdoauthClientSecretoauthAuthorizationUrloauthTokenRequestUrloauthScope のパラメーターを追加しました。

    • パラメーター認証方式に OAUTH_AUTHORIZATION_CODE パラメーターを追加しました。

  • OAuth 2.0クライアント認証フロー:

    • codenowrap:oauthClientIdoauthClientSecretoauthTokenRequestUrloauthScope パラメーターを追加しました。

    • パラメーター認証方式に OAUTH_CLIENT_CREDENTIALS パラメーターを追加しました。

  • OAuth トークンキャッシュ: ドライバー設定にユーザー名を渡す必要があり、 clientStoreTemporaryCredential プロパティを false には設定できません。

免責事項:

  • これらの機能には、環境変数 SF_ENABLE_EXPERIMENTAL_AUTHENTICATIONtrue に設定しないとアクセスできません。

  • これらの機能の使用は、本番以外のデータに制限してください。

  • これらのPrPr機能はサポート対象外です。ただし、PrPrの段階での製品チームとエンジニアリングチームによる対応は可能です。

  • 参加方法およびドキュメントについては、担当のアカウントチームまでご連絡ください。

新機能および更新

  • クエリメタデータ取得時の例外メッセージを改善しました。

  • codenowrap:ENABLE_EXACT_SCHEMA_SEARCH_ENABLED パラメーターを追加し、いくつかの DatabaseMetaData メソッドで正確なスキーマ検索を可能にしました。

  • DataSource にユーザー名やパスワードがない場合のエラーメッセージをより明確にしました。

  • 以下の依存関係を変更しました。

    • nettyをバージョン 4.1.118.Finalに変更しました

    • json-smartをバージョン2.5.2に変更しました

    • asmをバージョン9.7.1に変更しました

  • codenowrap:CLIENT_REQUEST_MFA_TOKEN フラグを string から boolean に変換する機能を追加しました。

  • クエリのタイムアウトをサーバー側かクライアント側のいずれかでセットできる機能を追加しました。

バグ修正

  • グローバルリクエスト設定におけるプロキシ設定の誤った動作を修正しました。

  • ログレベルが OFF に設定されている場合に、ログが空にならない動作を修正しました。

  • PUTコマンドで3重スラッシュのファイルプレフィックス(file:///)を使用できるようファイルパスを修正しました。

  • codenowrap:`uploadFileCallable`によってスローされた例外は、サイレントに失敗するのではなくメインスレッドに伝搬されるようになりました。

バージョン3.22.0(2025年1月29日)

新機能および更新

  • 以下の接続パラメーターを追加しました。

    • 実行に成功した後のみバッチをクリアする CLEAR_BATCH_ONLY_AFTER_SUCCESSFUL_EXECUTION パラメーター。

    • 非推奨の disableOCSPChecks パラメーターを置き換える insecureMode パラメーター。

    • IMPLICIT_SERVER_SIDE_QUERY_TIMEOUT、クライアントとサーバーの両方で同期クエリのタイムアウトをセットするパラメーター。

  • サーバー上で非同期クエリをタイムアウトさせる SnowflakeStatement.setAsyncQueryTimeout メソッドを追加しました。

  • net.snowflake.jdbc.commons_logging_wrapper javaプロパティを追加し、 ommons-logging からのログの処理を構成できるようにしました。

バグ修正

  • GCS (Google Cloud Storage)の PUT/GET 操作において、プロトコルなしのエンドポイントの処理を修正しました。

  • 構造化型を含む結果をフェッチする際に toString が頻繁に呼び出されることによるパフォーマンスの問題を修正しました。

  • createArrayOf の大文字と小文字が区別されない問題を修正しました。

  • downloadStream で、同じプレフィックスを持つ異なるファイルをダウンロードできる問題を修正しました。

  • 認証が EXTERNALBROWSER として設定され、Windows環境で使用される場合に、 %PATH% 権限が昇格する可能性を修正しました。詳細については、 CVE-2025-24789 をご参照ください。

  • 認証が EXTERNALBROWSER または USERNAME_PASSWORD_MFA に設定されている場合に、Linux環境で作成され、トークンのキャッシュに使用されるファイルアクセス権と所有者の検証を修正しました。詳細については、 CVE-2025-24790 をご参照ください。