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

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

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

JDBC ドライバーのダウンロードリンク

JDBC ドライバーバージョン 2.0.21 は、JDBC API 4.1 および 4.2 のデータ基準に準拠しています。ドライバーをダウンロードする前に、お使いの 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 ドライバーのドキュメント

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

重要

複数のデータカタログのために 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 ドライバー移行ガイドを参照してください。