Athena JDBC 2.x ドライバー - Amazon Athena

Athena JDBC 2.x ドライバー

JDBC 接続を使用して、SQL Workbench などのビジネスインテリジェンスツールとその他アプリケーションに Athena を接続することができます。これを実施するには、このページにある Amazon S3 のリンクを使用し、Athena JDBC 2.x ドライバーをダウンロード、インストール、設定を行います。JDBC 接続 URL の構築については、ダウンロード版JDBC ドライバーインストールおよび設定ガイドを参照してください。アクセス許可については、「JDBC および ODBC 接続を介したアクセスの制御」を参照してください。JDBC ドライバーに関するフィードバックは、athena-feedback@amazon.com に電子メールでお問い合わせください。バージョン 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」を参照してください。

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

  • 4.1 ドライバー - 2023 年以降、JDBC バージョン 4.1 のドライバーサポートを終了します。今後、アップデートの予定はありません。JDBC 4.1 ドライバーを使用している場合は、4.2 ドライバーへの移行を強くお勧めします。

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

JDBC ドライバーバージョン 2.1.5 は、JDBC API 4.2 データ規格に準拠しており、JDK 8.0 またはそれ以降が必要です。ご使用の JRE (Java Runtime Environment) のバージョンを確認する方法については、Java の ドキュメントを参照してください。

JDBC 4.2 ドライバーの .jar ファイルをダウンロードするには、次のリンクを使用します。

次の .zip ファイルのダウンロードには、JDBC 4.2 用の .jar ファイル、および AWS SDK とそれに付随するドキュメント、リリースノート、ライセンス、契約書が含まれています。

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

JDBC ドライバーバージョン 2.1.5 は、JDBC API 4.2 データ規格に準拠しており、JDK 8.0 またはそれ以降が必要です。ご使用の JRE (Java Runtime Environment) のバージョンを確認する方法については、Java の ドキュメントを参照してください。

AWS SDK なしで JDBC 4.2 ドライバー .jar ファイルをダウンロードするには、次のリンクを使用してください。

次の .zip ファイルのダウンロードには、JDBC 4.2 用の .jar ファイル、および付属ドキュメント、リリースノート、ライセンス、契約書が含まれています。これには、AWS SDK は含まれません。

JDBC 2.x ドライバーのリリースノート、ライセンス契約、通知

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

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

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