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

「翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。」

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

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

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

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

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

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

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

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

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

重要

で複数のデータカタログに JDBC ドライバーを使用するには (Athena外部 Hive メタストアまたはフェデレーティッドクエリを使用する場合など)、JDBC 接続文字列に を含めます。MetadataRetrievalMethod=ProxyAPI

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

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

重要

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

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

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

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

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