Athena ドライバーを使用して Tableau との接続をトラブルシューティングする方法を教えてください。

解決策

ドライバーに関連する問題を解決する

ドライバーに関連する問題が発生した場合、次の例に類似したエラーメッセージが表示されます。

"The drivers required to connect to the data source are not installed.No Suitable driver Installed.Error code: AA76601F"

このエラーは、適切な Athena JDBC ドライバーを使用していない場合、または正しい場所にドライバーをダウンロードしなかった場合に発生します。

この問題を解決するには、次の手順を実行します。

1. AWS SDK バンドルを含む、最新バージョンの Athena JDBC ドライバーの JAR をダウンロードします。
2. Athena JDBC ドライバーを適切な Tableau ドライバーの場所に保存します。
   Windows では、Athena JDBC .jar ファイルを C:\Program Files\Tableau\Drivers フォルダに保存します。
   macOS では、Athena JDBC .jar ファイルを ~/Library/Tableau/Drivers フォルダに保存します。
   注: 複数の.jar ファイルを追加しないでください。複数の.jar ファイルを追加すると、ドライバー関連の問題が発生する可能性があります。
3. Tableau を再起動し、Athena に接続します。

接続タイムアウトを解決する

接続タイムアウトが発生した場合、次の例に類似したエラーメッセージが表示されます。

"com/amazonaws/ClientConfiguration Unable to connect to the Amazon Athena server athena.us-east-1.amazonaws.com.Check that the server is running and that you have access privileges to the requested database."

このエラーは、インストールされているホストのドライバーと Athena との間に接続が確立されていない場合に発生します。

注: 次のコマンドにおいて、aa-example-1 を実際の AWS リージョンに置き換えてください。Amazon Virtual Private Cloud (Amazon VPC) エンドポイントのコマンドでは、1234567890abcdef0 を VPC エンドポイント ID に置き換えてください。

この問題を解決するには、次の手順を実行します。

• ポート 443 および 444 を開きます。Athena はポート 443 を使用してホストに接続し、Athena ストリーミング API はポート 444 を使用してクエリ結果をストリーミングします。

• オペレーティングシステム (OS) で次のコマンドを実行し、ドライバーのホストマシンから、ポート 443 と 444 でのエンドポイントへの接続をテストします。
  Windows:

  telnet athena.aa-example-1.amazonaws.com 443
  
  telnet athena.aa-example-1.amazonaws.com 444

  macOS:

  nc -v athena.aa-example-1.amazonaws.com 443
  
  nc -v athena.aa-example-1.amazonaws.com 444

  プライベート DNS サーバーに Amazon VPC エンドポイントを使用する場合は、VPC エンドポイント ID をエンドポイントの先頭に追加します。次に、vpce サブドメインを追加します。
  Windows の VPC エンドポイント:

  telnet vpce-1234567890abcdef0.athena.aa-example-1.vpce.amazonaws.com 443
  
  telnet vpce-1234567890abcdef0.athena.aa-example-1.vpce.amazonaws.com 444

  macOS の VPC エンドポイント:

  nc -v vpce-1234567890abcdef0.athena.aa-example-1.vpce.amazonaws.com 443
  
  nc -v vpce-1234567890abcdef0.athena.aa-example-1.vpce.amazonaws.com 444

• 正しい AWS Identity and Access Management (IAM) ユーザーアクセスキー ID とシークレットアクセスキーを使用してください。また、Amazon Simple Storage Service (Amazon S3)、Athena、AWS Glue に必要なアクセス許可を追加してください。

クエリと接続に関連する問題のデバッグ

Tableau で Athena JDBC ドライバーログを有効にするには、次の手順を実行します。

1. 使用する OS に応じて、次の Datasources フォルダに athena.properties ファイルを作成します。
   Windows では、C:\Users\[YourUsername]\Documents\My Tableau Repository\Datasources フォルダを使用します。
   macOS では、~/Documents/My Tableau Repository/Datasources フォルダを使用します。

2. プロパティファイルを開き、次の内容を追加します。

   LogLevel=6
   LogPath=D:\test\
   UseAwsLogger=1

3. ファイルを保存し、Tableau を閉じます。

4. Athena に接続します。

完了すると、Datasources フォルダ内にログファイル AthenaJDBC_connection および AthenaJDBC_Driver が生成されます。