Athena での JDBC ドライバーの使用
JDBC 接続を使用して、SQL Workbench
JDBC ドライバーのダウンロードリンク
JDBC ドライバーバージョン 2.0.21 は、JDBC API 4.1 および 4.2 のデータ基準に準拠しています。ドライバーをダウンロードする前に、お使いの
Java Runtime Environment (JRE) のバージョンを確認
お使いのバージョンの JDK および JDBC データ基準に一致するドライバーをダウンロードします。
-
AthenaJDBC41.jar
は、JDBC 4.1 と互換性があり、JDK 7.0 以降が必要です。 -
AthenaJDBC42.jar
は、JDBC 4.2 と互換性があり、JDK 8.0 以降が必要です。
JDBC ドライバーのリリースノート、ライセンス契約、および表示
必要なバージョンをダウンロードしたら、リリースノートをお読みになり、ライセンス契約および表示を確認してください。
JDBC ドライバーのドキュメント
ドライバー用の次のドキュメントをダウンロードします。
-
JDBC ドライバーのインストールおよび設定ガイド
。このガイドを使用してドライバーをインストールし、設定します。 -
JDBC ドライバー移行ガイド
。このガイドを使用して以前のバージョンから現在のバージョンに移行します。
複数のデータカタログのために Athena で JDBC ドライバーを使用するには (外部の Hive メタストアまたは横串検索を使用する場合など)、JDBC 接続文字列に MetadataRetrievalMethod=ProxyAPI を含めてください。
以前のバージョンの JDBC ドライバーからの移行
現在の JDBC ドライバーバージョン 2.0.21 は、以前の JDBC ドライバーバージョン 2.0.9 のドロップインリプレースメントであり、JDBC ドライバーバージョン 2.0.9 と下位互換性があります。以下のステップで、ドライバーが動作することを確認する必要があります。
JDBC ドライバーのバージョン 2.0.5 以降を使用するには、athena:GetQueryResultsStream ポリシーアクションを許可する JDBC ドライバーを使用して、IAM プリンシパルにアクセス許可ポリシーをアタッチします。このポリシーアクションが API で直接公開されることはありません。これは、ストリーミング結果のサポートの一部として
JDBC ドライバーでのみ使用されます。ポリシーの例については、「AWSQuicksightAthenaAccess マネージドポリシー」を参照してください。
さらに、Athena がクエリ結果をストリーミングするために使用するポート 444 が、アウトバウンドトラフィックに対して開放されていることを確認してください。PrivateLink
エンドポイントを使用して Athena に接続するときは、PrivateLink エンドポイントにアタッチされているセキュリティグループが、ポート 444 上のインバウンドトラフィックに対して開放されていることを確認してください。ポート
444 がブロックされている場合は、「[Simba][AthenaJDBC](100123) An error has occurred.」というエラーメッセージが表示されます。列の初期化中の例外。
バージョン 2.0.2 からバージョン 2.0.5 以降へのアップグレードの詳細については、JDBC ドライバー移行ガイド
以前のバージョンの JDBC ドライバーの詳細については、「以前のバージョンの JDBC ドライバーの使用」を参照してください。
ドライバーをバージョン 1.x から 2.x に移行する場合は、既存の設定を新しい設定に移行する必要があります。バージョン 2.x のドライバーに移行することを強くお勧めします。詳細については、JDBC ドライバー移行ガイド
