2025年の JDBC Driver リリースノート¶
この記事には、 JDBC Driver のリリースノートが含まれています。また、該当する場合は以下が含まれます。
動作の変更
新機能
顧客向けバグ修正
Snowflake は、 JDBC Driver の更新にセマンティックバージョニングを使用します。
ドキュメントについては、 JDBCドライバー をご参照ください。
バージョン3.26.1(2025年8月29日)¶
新機能および更新¶
以下のパラメーターを含む TLS バージョン1.3のサポートを追加しました。
MIN_TLS_VERSIONは TLS ハンドシェイクを開始するときに使用する最小の SSL/TLS バージョンを指定します。MAX_TLS_VERSIONは TLS ハンドシェイクを開始するときに使用する最大の SSL/TLS バージョンを指定します。
バグ修正¶
MFA がOktaで有効になり、ネイティブOkta認証が使用される場合、
NullPointerExceptionの問題を修正しました。無期限にキャッシュされる
CloseableHttpClientの問題を修正しました。CVE-2025-3823 に対処するため、Nettyをバージョン4.1.124.Final に引き上げました。
バージョン 3.26.0(2025年8月13日)¶
新機能および更新¶
AWS、Azure、Google Cloud、Kubernetes プラットフォームでワークロード ID フェデレーションのサポートが追加されました。
Added the
workloadIdentityProviderconnection parameter.Added
WORKLOAD_IDENTITYto the values for theauthenticatorconnection parameter.
バグ修正¶
RFC 6749 セクション 3.1.2 に準拠するように、後続の/(スラッシュ)を削除して、リダイレクト URI の OAuth 認証コードのデフォルト値を修正しました。
接続プーリングで
SnowflakeChunkDownloaderを使用した際、NullPointerExceptionが発生するバグを修正しました。接続プーリングで
auto-configの使用を妨げていたバグを修正しました。テレメトリースレッドが原因でアプリケーションがすぐに終了しないバグを修正しました。
S3クライアントのプロキシ基本認証を強制しました。
ワークロード ID フェデレーションを使用するための
SF_ENABLE_EXPERIMENTAL_AUTHENTICATION環境変数の要件を削除しました。Dateデータ型の配列バインドを修正しました。
バージョン 3.25.1(2025年7月21日)¶
新機能および更新¶
DatabaseMetaDataSHOW ... IN ... コマンドでパターンを使用できるようにするENABLE_WILDCARDS_IN_SHOW_METADATA_COMMANDSパラーメーターを追加しました。ステージファイルを含むディレクトリに所有者のみの権限(0600)を強制する
OWNER_ONLY_STAGE_FILE_PERMISSIONS_ENABLEDパラメーターを追加しました。
バグ修正¶
ネットワーク再試行時の不要な例外ラップを修正しました。
TLS ネゴシエーション中の protocol_version エラーの再試行を追加しました。
デフォルトのトラストマネージャーが
X509ExtendedTrustManager. を拡張しない問題を修正しました。セッションログに欠落していたログパラメーターを追加しました。
バージョン 3.25.0(2025年7月9日)¶
新機能および更新¶
ワークロード IDフェデレーションの主権クラウドのサポートを追加し、古い発行者チェックを削除しました。
バグ修正¶
ワークロードに基づいて
TelemetryThreadPoolがスケーリングしないバグを修正しました。レガシー OAuth フローのアクセストークンの有効期限処理を修正しました。
HTTP 応答チェックの古いエラーログを削除しました。
バージョン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およびclientSecretOAUTH パラメーターにLOCAL_APPLICATIONのデフォルトを追加しました。
バグ修正¶
codenowrap:
BindUploaderを使って挿入した場合に、04.10.1582(グレゴリオ改正)より前のタイムスタンプを扱っていた問題を修正しました。NPEファイルがアクセスできない場合のキャッシュファイルへの書き込み処理を修正しました。
AWS のワークロード ID フェデレーションフェデレーションリクエスト署名を修正しました。
バージョン3.24.0(2025年4月30日)¶
プライベートプレビュー(PrPr)の特長¶
AWS 、Azure、 GCP およびKubernetesプラットフォームでワークロードIDフェデレーションのサポートを追加しました。
免責事項:
この機能にアクセスするには、環境変数
SF_ENABLE_EXPERIMENTAL_AUTHENTICATIONをtrueに設定する必要があります。この機能は本番用以外のデータでのみ使用してください。
このPrPr機能はサポート対象外です。ただし、PrPrの段階での製品チームとエンジニアリングチームによる対応は可能です。
参加方法およびドキュメントについては、担当のアカウントチームまでご連絡ください。
新機能および更新¶
PAT、OAuth 2.0認証コードフロー、OAuth 2.0クライアント認証情報フロー、OAuthトークンキャッシュのサポートを追加しました。
PAT: パラメーター認証方式に
PROGRAMMATIC_ACCESS_TOKENパラメーターを追加しました。OAuth 2.0 認証コードのフロー:
codenowrap:
oauthClientId、oauthClientSecret、oauthAuthorizationUrl、oauthTokenRequestUrl、oauthScopeのパラメーターを追加しました。パラメーター認証方式に
OAUTH_AUTHORIZATION_CODEパラメーターを追加しました。
OAuth 2.0クライアント認証フロー:
codenowrap:
oauthClientId、oauthClientSecret、oauthTokenRequestUrl、oauthScopeパラメーターを追加しました。パラメーター認証方式に
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:
oauthClientId、oauthClientSecret、oauthAuthorizationUrl、oauthTokenRequestUrl、oauthScopeのパラメーターを追加しました。パラメーター認証方式に
OAUTH_AUTHORIZATION_CODEパラメーターを追加しました。
OAuth 2.0クライアント認証フロー:
codenowrap:
oauthClientId、oauthClientSecret、oauthTokenRequestUrl、oauthScopeパラメーターを追加しました。パラメーター認証方式に
OAUTH_CLIENT_CREDENTIALSパラメーターを追加しました。
OAuth トークンキャッシュ: ドライバー設定にユーザー名を渡す必要があり、
clientStoreTemporaryCredentialプロパティをfalseには設定できません。
免責事項:
これらの機能には、環境変数
SF_ENABLE_EXPERIMENTAL_AUTHENTICATIONをtrueに設定しないとアクセスできません。これらの機能の使用は、本番以外のデータに制限してください。
これらの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に変換する機能を追加しました。クエリのタイムアウトをサーバー側かクライアント側のいずれかでセットできる機能を追加しました。
Linux用のファイルベースの認証情報キャッシュを実装および改善しました。これには、トークンキャッシュの強化が含まれます。
バグ修正¶
グローバルリクエスト設定におけるプロキシ設定の誤った動作を修正しました。
ログレベルが
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_wrapperjavaプロパティを追加し、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 をご参照ください。