Athena での JDBC ドライバーの使用 - Amazon Athena

Athena での JDBC ドライバーの使用

JDBC 接続を使用して、SQL Workbench などのビジネスインテリジェンスツールとその他アプリケーションに Athena を接続することができます。このためには、このページにある Amazon S3 へのリンクを使用して、Athena JDBC ドライバーをダウンロードし、インストールおよび設定を行います。アクセス許可については、「JDBC および ODBC 接続を介したアクセス」を参照してください。バージョン 2.0.24 以降では、2 つ (AWS SDK を含むものと含まないもの) のバージョンのドライバを使用できます。

重要

JDBC ドライバーを使用するときは、次の要件に注意してください。

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

  • athena:GetQueryResultsStream ポリシー – JDBC ドライバーを使用する IAM プリンシパルに athena:GetQueryResultsStream ポリシーアクションを追加します。このポリシーアクションが API で直接公開されることはありません。ストリーミング結果のサポートの一環として、ODBC および JDBC ドライバーでのみ使用されます。ポリシーの例については、「AWS 管理ポリシー: AWSQuicksightAthenaAccess」を参照してください。

AWS SDK を使用する JDBC ドライバー

JDBC ドライバーバージョン 2.0.31 は、JDBC API 4.1 および 4.2 のデータ標準に準拠しています。ご使用の JRE (Java Runtime Environment) のバージョンを確認する方法については、Java の ドキュメントを参照してください。JRE バージョンは、ドライバーで使用している JDBC API のバージョンによって異なります。

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

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

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

次の .zip ファイルのダウンロードには、JDBC 4.1 および 4.2 向けの .jar ファイル、および AWS SDK が含まれます。

AWS SDK を使用しない JDBC ドライバー

JDBC ドライバーバージョン 2.0.31 は、JDBC API 4.1 および 4.2 のデータ標準に準拠しています。ご使用の JRE (Java Runtime Environment) のバージョンを確認する方法については、Java の ドキュメントを参照してください。JRE バージョンは、ドライバーで使用している JDBC API のバージョンによって異なります。

お使いのバージョンの JDK および JDBC データ基準に一致するドライバーをダウンロードします。これらのファイルには、以下の AWS SDK は含まれていません。

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

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

次の .zip ファイルのダウンロードには、JDBC 4.1 および 4.2 向けの .jar ファイルが含まれています。これには、AWS SDK は含まれません。

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

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

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

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

JDBC ドライバーノート

複数のデータカタログのための JDBC ドライバーの使用

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