JDBC 接続を使用して、SQL Workbench
重要
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 ドライバーのドキュメント
ドライバー用の次のドキュメントをダウンロードします。
-
JDBC ドライバーのインストールおよび設定ガイド
。このガイドを使用してドライバーをインストールし、設定します。 -
JDBC ドライバー移行ガイド
。このガイドを使用して以前のバージョンから現在のバージョンに移行します。