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

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

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

JDBC 接続を使用して Athena をビジネスインテリジェンスツールや他のアプリケーション (SQL Workbench など) に接続できます。これを行うには、Athena で次のリンクを使用して、Amazon S3 JDBC ドライバーをダウンロード、インストール、および設定します。アクセス許可の詳細については、「」JDBC および ODBC 接続を介したアクセスを参照してください。

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

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

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

  • AthenaJDBC41.jar は、JDBC 4.1 と互換性があり、JDK 7.0 以降が必要です。

  • AthenaJDBC42.jar は、JDBC 4.2 と互換性があり、JDK 8.0 以降が必要です。

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

さらに、クエリ結果のストリーミングに Athena が使用するポート 444 がアウトバウンドトラフィックに対して開かれていることを確認してください。PrivateLink エンドポイントを使用して Athena に接続する場合、PrivateLink エンドポイントにアタッチされているセキュリティグループで、ポート 444 がインバウンドトラフィックに対して開いていることを確認してください。ポート 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 ドライバー移行ガイドを参照してください。