JDBC ドライバーを介した Athena の使用 - Amazon Athena

JDBC ドライバーを介した Athena の使用

JDBC 接続を使用して Athena をビジネスインテリジェンスツールや他のアプリケーション (SQL Workbench など) に接続できます。これを行うには、Amazon S3 で次のリンクを使用して、Athena JDBC ドライバーをダウンロード、インストール、および設定します。

JDBC ドライバーをダウンロードするリンク

JDBC ドライバーバージョン 2.0.9 は、JDBC API 4.1 および 4.2 のデータ基準に準拠しています。ドライバーをダウンロードする前に、お使いの Java Runtime Environment (JRE) のバージョンを確認してください。JRE バージョンは、ドライバーで使用している JDBC API のバージョンによって異なります。ご不明な場合は、最新バージョンのドライバーをダウンロードしてください。

お使いのバージョンの JDK および JDBC データ基準に一致するドライバーをダウンロードします。

JDBC ドライバーのリリースノート、ライセンス契約、および表示

必要なバージョンをダウンロードしたら、リリースノートをお読みになり、ライセンス契約および表示を確認してください。

JDBC ドライバーのドキュメント

ドライバー用の次のドキュメントをダウンロードします。

プレビュー機能用の JDBC ドライバーをダウンロードするためのリンク

これらのドライバーは Athena プレビュー機能をサポートしています。お使いのバージョンの JDK および JDBC データ基準に一致するドライバーをダウンロードします。

JDBC ドライバーのリリースノート、ライセンス契約、プレビュードライバーに関する注意

必要なバージョンをダウンロードしたら、リリースノートをお読みになり、ライセンス契約および表示を確認してください。

プレビュードライバー用の JDBC ドライバードキュメント

ドライバー用の次のドキュメントをダウンロードします。

以前のバージョンの JDBC ドライバーから移行する

現在の JDBC ドライバーバージョン 2.0.9 は、以前の JDBC ドライバーバージョン 2.0.8 のドロップインリプレースメントであり、JDBC ドライバーバージョン 2.0.8 と下位互換性があります。以下のステップで、ドライバーが動作することを確認する必要があります。

重要

JDBC ドライバーのバージョン 2.0.5 以降を使用するには、athena:GetQueryResultsStream ポリシーアクションを許可する JDBC ドライバーを使用して、IAM プリンシパルにアクセス権限ポリシーをアタッチします。このポリシーアクションが API で直接公開されることはありません。これは、ストリーミング結果のサポートの一部として JDBC ドライバーでのみ使用されます。ポリシーの例については、「AWSQuicksightAthenaAccess 管理ポリシー」を参照してください。

さらに、クエリ結果のストリーミングに Athena が使用するポート 444 がアウトバウンドトラフィックに対して開かれていることを確認してください。PrivateLink エンドポイントを使用して Athena に接続する場合、PrivateLink エンドポイントにアタッチされているセキュリティグループで、ポート 444 がインバウンドトラフィックに対して開いていることを確認してください。ポート 444 がブロックされている場合、エラーメッセージ「[Simba][AthenaJDBC](100123) An error has occurred」が表示されます。列の初期化中の例外

バージョン 2.0.2 からバージョン 2.0.5 以降へのアップグレードの詳細については、JDBC ドライバー移行ガイドを参照してください。

以前のバージョンの JDBC ドライバーの詳細については、「以前のバージョンの JDBC ドライバーを使用する」を参照してください。

ドライバーをバージョン 1.x から 2.x に移行する場合は、既存の設定を新しい設定に移行する必要があります。バージョン 2.x のドライバーに移行することを強くお勧めします。詳細については、JDBC ドライバー移行ガイドを参照してください。