# Amazon Athena ODBC 3.x リリースノート
これらのリリースノートには、Amazon Athena JDBC 3.x ドライバーの改良と修正の詳細が記載されています。
## 3.7.0
2025 年 11 月 21 日リリース
### 改良点
+ **「ブラウザ OIDC の信頼できる ID の伝搬」認証プラグイン** – OpenID Connect (OIDC) ID プロバイダーによるシームレスなブラウザベース認証を可能にする新しい認証プラグインを追加しました。このプラグインは、デフォルトのブラウザを介した完全な OAuth 2.0 フローの処理、JSON ウェブトークン（JWT）の自動取得、信頼できる ID の伝搬との統合を行います。シングルユーザーデスクトップ環境専用に設計されており、JWT の手動処理よりも効率的な認証エクスペリエンスを提供します。信頼できる ID の伝播の詳細については、「[信頼できる ID の伝播とは](https://docs.aws.amazon.com/singlesignon/latest/userguide/trustedidentitypropagation-overview.html)」を参照してください。
### 修正内容
+ **タイムスタンプ精度サポートの強化** – ドライバーは、`getTimestamp()` メソッドを介して Athena クエリから返されるタイムスタンプ値のミリ秒とナノ秒の精度を完全にサポートするようになりました。
+ **複雑な型処理の改善** – `DatabaseMetaData#getColumns` と一般的なメタデータオペレーションの両方でネストされたデータ型 (配列、構造体、マップ) を解析する際の問題を修正し、複雑なデータ構造の型情報の精度を確保しました。
+ **エラーログ記録の強化** – エラーメッセージがより明確になって診断情報が向上するように、S3 メタデータ取得失敗のログ記録を改善しました。
## 3.6.0
2025 年 9 月 10 日リリース
### 改良点
+ **JWT の信頼できる ID の伝播認証プラグイン** – JWT の信頼できる ID の伝播と JDBC ドライバーの統合をサポートする新しい認証プラグインが追加されました。この認証タイプでは、外部 ID プロバイダーから取得した JSON Web トークン (JWT) を接続パラメータとして使用して Athena で認証できます。信頼できる ID の伝播では、ID コンテキストが IAM ロールに追加され、AWS リソースへのアクセスをリクエストするユーザーを識別します。信頼できる ID の伝播の有効化と使用方法の詳細については、「[信頼できる ID の伝播とは](https://docs.aws.amazon.com/singlesignon/latest/userguide/trustedidentitypropagation-overview.html)」を参照してください。
+ **カスタム SSO OIDC および SSO Admin エンドポイントのサポート** – JDBC ドライバーでカスタム SSO OIDC および SSO Admin エンドポイントのサポートが追加されました。この機能強化により、VPC の背後で JDBC を実行するときに SSO サービス用の独自のエンドポイントを指定できます。
+ **AWS SDK バージョンの更新** – ドライバーで使用される AWS SDK バージョンを 2.32.16 に更新し、リリース 3.6.0 のプロジェクトの依存関係を更新しました。
## 3.5.1
2025 年 7 月 17 日リリース
### 改良点
+ **ログ記録機能** – ログレベルを `INFO` に引き上げ、行数、オフセット、オブジェクト長のメトリクスを追加することで、S3 フェッチログ記録を強化しました。接続ライフサイクルの追跡を実装し、全体的なログ記録パフォーマンスを最適化しました。
+ **特殊文字の処理** — スキーマ名とカタログ名の `LIKE` パターンの特殊文字の処理が改善されました。
+ **接続状態管理** – 接続状態管理を改善し、接続の閉鎖後に API コールを防止し、シャットダウン中のクエリオペレーションの安全チェックを追加することで、潜在的なエラーを防止しました。
### 修正内容
+ **DDL クエリメタデータ** – DDL クエリメタデータ処理の `NoSuchKeyFound` 問題を修正しました。
## 3.5.0
2025 年 3 月 18 日リリース
### 改良点
+ **結果設定パラメータ** – 2 つの新しい接続パラメータ `ExpectedBucketOwner` と`AclOption` のサポートが追加されました。詳細については、「[Result configuration parameters](jdbc-v3-driver-advanced-connection-parameters.md#jdbc-v3-driver-result-config)」を参照してください。
+ **AWS SDK バージョン** – ドライバーで使用されている AWS SDK バージョンが 2.30.22 に更新されました。
## 3.4.0
2025 年 2 月 18 日リリース
### 改良点
+ **結果フェッチャー** – ドライバーは、クエリ結果をダウンロードする最も速い方法を自動的に選択するようになりました。これにより、ほとんどの場合、フェッチャーを手動で設定する必要がなくなります。詳細については、「[結果フェッチパラメータ](jdbc-v3-driver-advanced-connection-parameters.md#jdbc-v3-driver-result-fetching-parameters)」を参照してください。
### 修正内容
+ **ResultSet** – ドライバーは、S3 で結果オブジェクトを生成しない DDL ステートメントの結果セットに対する反復処理を処理するようになりました。また、`GetQueryResultsStream` が完全に空のページを返すとき、null ではなく空の `ResultSet` オブジェクトが返されます。
+ **ResultsStream** – 結果のストリーミングは、内部バッファの行数をカウントする不要な呼び出しを削除することで最適化されています。
+ **getTables** – `GetTables` の呼び出しは、 `ListTableMetadata` と `GetTableMetadata` の応答に基づいてテーブルタイプを処理することで最適化されています。
## 3.3.0
2024 年 10 月 30 日リリース
### 改良点
+ **DataZone 認証** – DataZone 認証プラグイン `DataZoneIdC` と `DataZoneIAM` のサポートが追加されました。詳細については、「[DataZone IdC 認証情報プロバイダー](jdbc-v3-driver-datazone-idc.md)」および「[DataZone IAM 認証情報プロバイダー](jdbc-v3-driver-datazone-iamcp.md)」を参照してください。
+ **ネットワークタイムアウト** – `NetworkTimeoutMillis` 接続パラメータを使用してネットワークタイムアウトを設定できるようになりました。以前は、`Connection` オブジェクト自体にのみ設定することができました。詳細については、「[ネットワークタイムアウト](jdbc-v3-driver-other-configuration.md#jdbc-v3-driver-network-timeout)」を参照してください。
### 修正内容
+ **S3 空のオブジェクト処理** – ドライバーは、Amazon S3 Range Not Satisfiable 例外をスローする代わりに、S3 フェッチャー内の空のオブジェクトを処理するようになりました。
+ **ログ記録** – クエリ結果を使用した後、ドライバーは、メッセージ「Items requested for query execution [...], but subscription is cancelled」をログに記録しなくなりました。
+ **空のパラメータ文字列** – ドライバーは、接続パラメータに存在する空の文字列を、パラメータが存在しないかのように処理するようになりました。これにより、一部の BI ツールが誤って空の文字列を渡して意図しない認証の試行が発生したときに発生する問題が解決されます。
## 3.2.2
2024 年 7 月 29 日リリース
### 改良点
+ **データ型マッピング** — ドライバーが `tinyint`、`smallint`、`row`、および `struct` データ型を Java オブジェクトにマッピングする方法を変更することで、JDBC 仕様への準拠を改善しました。
+ **AWS SDK バージョンの更新** – ドライバーで使用されている AWS SDK バージョンが 2.26.23 に更新されました。
### 修正内容
+ **コメント** – ステートメントの最後にある行コメントの問題を修正しました。
+ **データベースのリスト** — ページ分割された `ListDatabases` API によって返された最後のページが空の場合に、リストデータベースが無限ループに入る可能性がある問題を修正しました。
## 3.2.1
2024 年 7 月 3 日リリース
### 改良点
+ **JWT 認証情報プロバイダー** – ユーザー指定のセッション期間のサポートが追加されました。詳細については、「[ロールセッションの期間](jdbc-v3-driver-jwt-credentials.md#jdbc-v3-driver-jwt-role-session-duration)」を参照してください。
### 修正内容
+ **スレッドプール** – `ForkJoin` プールを使用しないように、非同期タスク用に接続ごとに `ThreadPoolExecutor` が 1 つずつ作成されました。
+ **認証情報プロバイダー** – HTTP クライアントが外部 IdP 用に設定されている場合、プロキシホストが解析され、スキームとホストが取得されるようになりました。
+ **デフォルトの認証情報プロバイダー** – デフォルトの認証情報プロバイダーをクライアントコードで閉じることができないようにしました。
+ **getColumns** – `DatabaseMetaData#getColumns` メソッドの `ORDINAL_COLUMN` 列プロパティの問題を修正しました。
+ **ResultSet** – `Infinity`、`-Infinity`、および `NaN` のサポートが `ResultSet.` に追加されました カタログオペレーションから返される列タイプと、完了したクエリの結果セットの間の不一致が修正されました。
## 3.2.0
2024 年 4 月 26 日リリース
### 改良点
+ **カタログ操作のパフォーマンス** – ワイルドカード文字を使用しないカタログ操作のパフォーマンスが改善されました。
+ **最小ポーリング間隔の変更** – 最小ポーリング間隔のデフォルトを変更し、ドライバーが Athena に対して行う API 呼び出し回数を減らしました。クエリ候補がすばやく検出されます。
+ **BI ツールの検出可能性** – ビジネスインテリジェンスツールのドライバーをより簡単に検出できるようになりました。
+ **データ型マッピング** – Athena `binary`、`array`、および `struct` DDL データ型へのデータ型マッピングが改善されました。
+ **AWS SDK バージョン** – ドライバーで使用されている AWS SDK バージョンが 2.25.34 に更新されました。
### 修正内容
+ **フェデレーションカタログのテーブルリスト** – フェデレーションカタログが空のテーブルリストを返す問題を修正しました。
+ **getSchemas** – JDBC [DatabaseMetadata\$1getSchemas](https://docs.oracle.com/javase/8/docs/api/java/sql/DatabaseMetaData.html#getSchemas--) メソッドが、すべてのカタログからではなくデフォルトのカタログからのみデータベースを取得する問題を修正しました。
+ **getColumns** – JDBC [DatabaseMetadata\$1getColumns](https://docs.oracle.com/javase/8/docs/api/java/sql/DatabaseMetaData.html#getColumns-java.lang.String-java.lang.String-java.lang.String-java.lang.String-) メソッドが null カタログ名で呼び出されたときに、null カタログが返される問題を修正しました。
## 3.1.0
2024 年 2 月 15 日リリース
### 改良点
+ Microsoft Active Directory Federation Services (AD FS) Windows 統合認証とフォームベース認証のサポートが追加されました。
+ バージョン 2.x との下位互換性を保つため、`awsathena` JDBC サブプロトコルが受け入れられるようになりましたが、非推奨の警告が生成されます。代わりに `athena` JDBC サブプロトコルを使用してください。
+ `AwsDataCatalog` がカタログパラメータのデフォルトとなり、`default` がデータベースパラメータのデフォルトとなりました。これらの変更により、現在のカタログとデータベースの正しい値 ( NULL ではない) が返されるようになりました。
+ JDBC 仕様に準拠し、`IS_AUTOINCREMENT` と `IS_GENERATEDCOLUMN` は `NO` ではなく空の文字列を返すようになりました。
+ Athena `int` データ型は、`other` ではなく Athena `integer` と同じ JDBC 型にマップされるようになりました。
+ Athena の列メタデータにオプションの `precision` および `scale` フィールドが含まれていない場合、ドライバーは `ResultSet` 列内の対応する値に 0 を返すようになりました。
+ AWS SDK バージョンは、2.21.39 に更新されました。
### 修正内容
+ Athena からのプレーンテキスト結果の列数が Athena 結果メタデータの列数と一致しない場合に例外が発生する `GetQueryResultsStream` の問題を修正しました。
## 3.0.0
2023 年 11 月 16 日リリース
Athena JDBC 3.x ドライバーは、より優れたパフォーマンスと互換性を提供する新世代ドライバーです。JDBC 3.x ドライバーは、Amazon S3 からの直接的なクエリ結果の読み取りをサポートするので、大規模なクエリ結果を使用するアプリケーションのパフォーマンスが向上します。新しいドライバーではサードパーティーとの依存関係も少なくなっているため、BI ツールやカスタムアプリケーションとの統合が容易になります。