Amazon Athena ODBC 3.x リリースノート

JWT の信頼できる ID の伝播認証プラグイン – JWT の信頼できる ID の伝播と JDBC ドライバーの統合をサポートする新しい認証プラグインが追加されました。この認証タイプでは、外部 ID プロバイダーから取得した JSON Web トークン (JWT) を接続パラメータとして使用して Athena で認証できます。信頼できる ID の伝播では、ID コンテキストが IAM ロールに追加され、AWS リソースへのアクセスをリクエストするユーザーを識別します。信頼できる ID の伝播の有効化と使用方法の詳細については、「信頼できる ID の伝播とは」を参照してください。

カスタム SSO OIDC および SSO Admin エンドポイントのサポート – JDBC ドライバーでカスタム SSO OIDC および SSO Admin エンドポイントのサポートが追加されました。この機能強化により、VPC の背後で JDBC を実行するときに SSO サービス用の独自のエンドポイントを指定できます。

AWS SDK バージョンの更新 – ドライバーで使用される AWS SDK バージョンを 2.32.16 に更新し、リリース 3.6.0 のプロジェクトの依存関係を更新しました。

ログ記録機能 – ログレベルを INFO に引き上げ、行数、オフセット、オブジェクト長のメトリクスを追加することで、S3 フェッチログ記録を強化しました。接続ライフサイクルの追跡を実装し、全体的なログ記録パフォーマンスを最適化しました。

特殊文字の処理 — スキーマ名とカタログ名の LIKE パターンの特殊文字の処理が改善されました。

接続状態管理 – 接続状態管理を改善し、接続の閉鎖後に API コールを防止し、シャットダウン中のクエリオペレーションの安全チェックを追加することで、潜在的なエラーを防止しました。

DDL クエリメタデータ – DDL クエリメタデータ処理の NoSuchKeyFound 問題を修正しました。

結果設定パラメータ – 2 つの新しい接続パラメータ ExpectedBucketOwner とAclOption のサポートが追加されました。詳細については、「Result configuration parameters」を参照してください。

AWS SDK バージョン – ドライバーで使用されている AWS SDK バージョンが 2.30.22 に更新されました。

結果フェッチャー – ドライバーは、クエリ結果をダウンロードする最も速い方法を自動的に選択するようになりました。これにより、ほとんどの場合、フェッチャーを手動で設定する必要がなくなります。詳細については、「結果フェッチパラメータ」を参照してください。

ResultSet – ドライバーは、S3 で結果オブジェクトを生成しない DDL ステートメントの結果セットに対する反復処理を処理するようになりました。また、GetQueryResultsStream が完全に空のページを返すとき、null ではなく空の ResultSet オブジェクトが返されます。

ResultsStream – 結果のストリーミングは、内部バッファの行数をカウントする不要な呼び出しを削除することで最適化されています。

getTables – GetTables の呼び出しは、 ListTableMetadata と GetTableMetadata の応答に基づいてテーブルタイプを処理することで最適化されています。

DataZone 認証 – DataZone 認証プラグイン DataZoneIdC と DataZoneIAM のサポートが追加されました。詳細については、「DataZone IdC 認証情報プロバイダー」および「DataZone IAM 認証情報プロバイダー」を参照してください。

ネットワークタイムアウト – NetworkTimeoutMillis 接続パラメータを使用してネットワークタイムアウトを設定できるようになりました。以前は、Connection オブジェクト自体にのみ設定することができました。詳細については、「ネットワークタイムアウト」を参照してください。

S3 空のオブジェクト処理 – ドライバーは、Amazon S3 Range Not Satisfiable 例外をスローする代わりに、S3 フェッチャー内の空のオブジェクトを処理するようになりました。

ログ記録 – クエリ結果を使用した後、ドライバーは、メッセージ「Items requested for query execution [...], but subscription is cancelled」をログに記録しなくなりました。

空のパラメータ文字列 – ドライバーは、接続パラメータに存在する空の文字列を、パラメータが存在しないかのように処理するようになりました。これにより、一部の BI ツールが誤って空の文字列を渡して意図しない認証の試行が発生したときに発生する問題が解決されます。

データ型マッピング — ドライバーが tinyint、smallint、row、および struct データ型を Java オブジェクトにマッピングする方法を変更することで、JDBC 仕様への準拠を改善しました。

AWS SDK バージョンの更新 – ドライバーで使用されている AWS SDK バージョンが 2.26.23 に更新されました。

コメント – ステートメントの最後にある行コメントの問題を修正しました。

データベースのリスト — ページ分割された ListDatabases API によって返された最後のページが空の場合に、リストデータベースが無限ループに入る可能性がある問題を修正しました。

JWT 認証情報プロバイダー – ユーザー指定のセッション期間のサポートが追加されました。詳細については、「ロールセッションの期間」を参照してください。

スレッドプール – ForkJoin プールを使用しないように、非同期タスク用に接続ごとに ThreadPoolExecutor が 1 つずつ作成されました。

認証情報プロバイダー – HTTP クライアントが外部 IdP 用に設定されている場合、プロキシホストが解析され、スキームとホストが取得されるようになりました。

デフォルトの認証情報プロバイダー – デフォルトの認証情報プロバイダーをクライアントコードで閉じることができないようにしました。

getColumns – DatabaseMetaData#getColumns メソッドの ORDINAL_COLUMN 列プロパティの問題を修正しました。

ResultSet – Infinity、-Infinity、および NaN のサポートが ResultSet. に追加されました カタログオペレーションから返される列タイプと、完了したクエリの結果セットの間の不一致が修正されました。

カタログ操作のパフォーマンス – ワイルドカード文字を使用しないカタログ操作のパフォーマンスが改善されました。

最小ポーリング間隔の変更 – 最小ポーリング間隔のデフォルトを変更し、ドライバーが Athena に対して行う API 呼び出し回数を減らしました。クエリ候補がすばやく検出されます。

BI ツールの検出可能性 – ビジネスインテリジェンスツールのドライバーをより簡単に検出できるようになりました。

データ型マッピング – Athena binary、array、および struct DDL データ型へのデータ型マッピングが改善されました。

AWS SDK バージョン – ドライバーで使用されている AWS SDK バージョンが 2.25.34 に更新されました。

フェデレーションカタログのテーブルリスト – フェデレーションカタログが空のテーブルリストを返す問題を修正しました。

getSchemas – JDBC DatabaseMetadata#getSchemas メソッドが、すべてのカタログからではなくデフォルトのカタログからのみデータベースを取得する問題を修正しました。

getColumns – JDBC DatabaseMetadata#getColumns メソッドが null カタログ名で呼び出されたときに、null カタログが返される問題を修正しました。

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 の問題を修正しました。