如何在我的 Athena JDBC/ODBC 驅動程式中啟用偵錯日誌？

解決方案

**重要：**僅在擷取問題所需的時間內啟用偵錯日誌。日誌記錄會降低效能，而且可能會佔用大量磁碟空間。

JDBC 驅動程式

您可以使用 JDBC 驅動程式版本 2.x 和 3.x 連線到 Athena。如需 JDBC 版本 2.x 和 3.x 不同參數的資訊，請參閱日誌層級。

啟用 Athena JDBC 版本 2.x 的偵錯日誌

若要啟用偵日誌，請在 Athena JDBC 2.x 驅動程式中設定下列屬性：

• 對於「 LogLevel」，選取「 5」。
• 對於「 UseAwsLogger，選取「 1」。
  **注意：**使用此屬性時，JDBC 驅動程式也會記錄來自 AWS API 呼叫的資訊。
• 對於「LogPath」，請在主機上輸入要擷取驅動程式日誌的位置。

**注意：**您也可以在商業智慧工具中設定類似的選項，以啟用偵錯日誌。

請確保重新啟動 JDBC 應用程式，然後重新連線至伺服器。

如需啟用的日誌檔的詳細資訊，請參閱 insightsoftware 網站上的設定日誌記錄。

啟用 Athena JDBC 版本 3.x 的偵錯日誌

若要啟用偵日誌，請在 Athena JDBC 3.x 驅動程式中設定下列屬性：

• 對於「LogLevel」，選取「DEBUG」。
• 對於「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 電腦啟用偵錯日誌，請完成下列步驟：

1. 從 Windows 開始功能表中，選擇 ODBC 資料來源。
2. 在 ODBC Data Source Administrator 中，選擇系統 DSN 標籤。
3. 選擇新增。
4. 從驅動程式清單中，選擇 Simba Athena ODBC 驅動程式。
5. 選擇完成。
   注意： 新精靈隨即開啟，您可以在其中新增資訊，例如 AWS 區域、架構、工作群組、Amazon Simple Storage Service (Amazon S3) 輸出位置，以及 AWS Key Management Service (KMS) 金鑰。
6. 選擇日誌記錄選項。
   對於「 日誌層級」，選取「 資訊」。
   在記「 日誌路徑」中，選取 Windows 電腦上的路徑。
   選擇確定。

ODBC 驅動程式日誌會在您選取的日誌路徑中產生。

若要啟用 Linux 或 macOS 電腦驅動程式中的偵錯日誌，請完成下列任務：

**Linux：**編輯 /opt/simba/athenaodbc/lib/64/simba.athenaodbc.ini 檔案，然後設定下列屬性：

• 對於「 LogLevel」，選取「 5」。
• 對於「LogPath」，輸入主機的路徑。

**macOS：**編輯 /Library/simba/athenaodbc/lib/simba.athenaodbc.ini 檔案，然後設定下列屬性：

• 對於「 LogLevel」，選取「 5」。
• 對於「LogPath」，輸入主機的路徑。

請確保重新啟動 ODBC 應用程式，然後重新連線至伺服器。

如需啟用的日誌檔的詳細資訊，請參閱 insightsoftware 網站上的設定日誌記錄選項。

啟用 Athena ODBC 2.x 驅動程式的偵錯日誌

為 Windows、Linux 或 macOS 電腦下載 Athena ODBC 2.x 驅動程式。然後，為您的作業系統 (OS) 建立資料來源。

若要為 Windows 電腦啟用偵錯日誌，請完成下列步驟：

1. 從 Windows 開始功能表中，選擇 ODBC 資料來源。
2. 在 ODBC Data Source Administrator 中，選擇資料來源名稱。
3. 選擇設定，然後選擇日誌記錄選項。
4. 更新下列參數：
   對於日誌層級，選擇日誌層級： 1。
   在記「 日誌路徑」中，選取 Windows 電腦上的路徑。
   (選用) 若要啟用 AWS SDK 日誌，請選擇啟用 AWS Logger。
5. 選擇確定。

若要為 macOS 電腦啟用偵錯日誌，請完成下列步驟：

1. 在 macOS 上安裝 ODBC 資料連接器。
2. 在下列位置開啟處理器的 odbc.ini 檔案：
   Intel 處理器：/opt/athena/odbc/x86_64/ini/
   ARM 處理器：/opt/athena/odbc/arm64/ini/
3. 更新下列參數：
   對於「LogLevel」，選取「1」。
   (選用) 對於「UseAwsLogger」，選取「1」。
   對於「LogPath」，輸入主機的路徑。
4. 使用 iodbctest 命令行工具驗證連線。

若要為 Linux 電腦啟用偵錯日誌，請完成下列步驟：

1. 在 Linux 上安裝 ODBC 資料連接器。
2. 開啟 /opt/athena/odbc/ini/odbc.ini 檔案。
3. 更新下列參數：
   對於「LogLevel」，選取「1」。
   (選用) 對於「UseAwsLogger」，選取「1」。
   對於「LogPath」，輸入主機的路徑。
4. 使用 unixODBC isql 命令行工具驗證連線。

ODBC 驅動程式日誌會在您選取的日誌路徑中產生。

相關資訊

使用 ODBC 和 JDBC 驅動程序連線到 Amazon Athena

insightsoftware 網站上的 Athena ODBC 和 JDBC 驅動程式