Amazon Athena Java データベース接続 (JDBC) /オープンデータベース接続 (ODBC) ドライバーのデバッグログを有効にして、問題のトラブルシューティングに役立てたいと考えています。
解決策
**重要:**デバッグログは、問題を把握するのに必要な時間だけ有効にします。ログを記録するとパフォーマンスが低下し、大量のディスク容量が使用される可能性があります。
JDBC ドライバー
JDBC ドライバーバージョン 2.x および 3.x を使用して Athena に接続できます。JDBC バージョン 2.x と 3.x のさまざまなパラメータについては、「ログレベル」を参照してください。
Athena JDBC バージョン 2.x のデバッグログを有効にする
デバッグログを有効にするには、Athena JDBC 2.x ドライバーで以下のプロパティを設定します。
- [ログレベル] で [5] を選択します。
- [UseAwsLogger] で [1] を選択します。
**注:**このプロパティを使用すると、JDBC ドライバーは AWS API コールの情報も記録します。
- LogPath には、ドライバーログをキャプチャするホストマシン上の場所を入力します。
**注:**ビジネスインテリジェンスツールで同様のオプションを設定して、デバッグログをアクティブにすることもできます。
必ず JDBC アプリケーションを再起動してから、サーバーに再接続してください。
有効化されたログファイルの詳細については、insightsoftware のウェブサイトの「Configuring logging 」を参照してください。
Athena JDBC バージョン 3.x のデバッグログを有効にする
デバッグログを有効にするには、Athena JDBC 3.x ドライバーで以下のプロパティを設定します。
- [ログレベル] で [デバッグ] を選択します。
- LogPath には、ドライバーログをキャプチャするホストマシン上の場所を入力します。
**注:**ビジネスインテリジェンスツールで同様のオプションを設定して、デバッグログをアクティブにすることもできます。
新しい設定を有効にするには、JDBC アプリケーションを再起動してからサーバーに再接続してください。
Athena JDBC 3.x ドライバーによって、 LogPath プロパティで指定された場所にログファイルが生成されます。
ODBC ドライバー
ODBC ドライバーバージョン 1.x と 2.x を使用して Athena に接続できます。詳細と ODBC ドライバーのダウンロードについては、「 ODBC を使用した Amazon Athena への接続」を参照してください。
Athena ODBC 1.x ドライバーのデバッグログを有効にする
お使いの Windows、Linux、または macOS 用の Athena ODBC 1.x ドライバーをダウンロードします。
Windows のデバッグログを有効にするには、次の手順を実行します。
- Windows の [スタート] メニューで [ODBC データソース] を選択します。
- [ODBC データソースア ドミニストレーター] で [**システム DSN **] タブを選択します。
- [追加] を選択します。
- ドライバーのリストから、[Simba Athena ODBC Driver] を選択します。
- [完了] を選択します。
**注:**新しいウィザードが開き、AWS リージョン、スキーマ、ワークグループ、Amazon Simple Storage Service (Amazon S3) の出力場所、AWS Key Management Service (AWS KMS) キーなどの情報を追加できます。
- [ログ記録オプション] を選択します。
[ログレベル] で [情報] を選択します。
[ログパス] で、Windows 上のパスを選択します。
[OK] を選択します。
ODBC ドライバーログは、選択したログパスに生成されます。
Linux または macOS のドライバーでデバッグログを有効にするには、次のタスクを実行します。
Linux の場合:****/opt/simba/athenaodbc/lib/64/simba.athenaodbc.ini ファイルを編集し、次のプロパティを設定します。
- [ログレベル] で [5] を選択します。
- [LogPath] にはホストへのパスを入力します。
macOS の場合:****/Library/simba/athenaodbc/lib/simba.athenaodbc.ini ファイルを編集し、次のプロパティを設定します。
- [ログレベル] で [5] を選択します。
- [LogPath] にはホストへのパスを入力します。
必ず ODBC アプリケーションを再起動してから、サーバーに再接続してください。
有効化されたログファイルの詳細については、insightsoftwareのウェブサイトの「Configuring logging options」を参照してください。
Athena ODBC 2.x ドライバーのデバッグログを有効にする
お使いの Windows、Linux、または macOS 用の Athena ODBC 2.x ドライバーをダウンロードします。次に、オペレーティングシステム (OS) のデータソースを作成 します。
Windows のデバッグログを有効にするには、次の手順を実行します。
- Windows の [スタート] メニューで [ODBC データソース] を選択します。
- [ODBC データソース アドミニストレーター] で、データソース名を選択します。
- [設定] を選択し、[ログオプション] を選択します。
- 次のパラメータを使用してください。
[ログレベル] で ログレベルを選択します。 1.
[ログパス] で、Windows 上のパスを選択します。
(オプション) AWS SDK ログを有効にするには、[AWS ロガーを有効にする] を選択します。
- [OK] を選択します。
macOS のデバッグログを有効にするには、次の手順を実行します。
- MacOS に ODBC データコネクタをインストールします。
- 使用しているプロセッサーの次の場所にある odbc.ini を開きます。
インテルプロセッサー: /opt/athena/odbc/x86_64/ini/
ARM プロセッサ: /opt/athena/odbc/arm64/ini/
- 次のパラメータを使用してください。
[ログレベル] で [1] を選択します。
(オプション) [UseAwsLogger] で [1]を選択します。
[LogPath] にはホストへのパスを入力します。
- **iodbctest ** コマンドラインツールを使用して接続を確認します。
Linux のデバッグログを有効にするには、次の手順を実行します。
- ODBC データコネクタを Linux にインストールします。
- **/opt/athena/odbc/ini/odbc.ini ** ファイルを開きます。
- 次のパラメータを使用してください。
[ログレベル] で [1] を選択します。
(オプション) [UseAwsLogger] で [1]を選択します。
[LogPath] にはホストへのパスを入力します。
- **unixODBC isql ** コマンドラインツールを使用して接続を確認します。
ODBC ドライバーログは、選択したログパスに生成されます。
関連情報
ODBC および JDBC ドライバーを使用した Amazon Athena への接続
insightsoftware のウェブサイトのAthena ODBC & JDBC Driver