如何激活我的 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 网站上的 Configuring logging。

激活 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 数据来源管理器中，选择系统 DSN 选项卡。
3. 选择添加。
4. 从驱动程序列表中选择 Simba Athena ODBC 驱动程序。
5. 选择完成。
   **注意：**将打开一个新的向导，您可以在其中添加信息，例如 AWS 区域、架构、工作组、Amazon Simple Storage Service（Amazon S3）输出位置和 AWS Key Management Service（AWS 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 网站上的 Configuring logging options。

激活 Athena ODBC 2.x 驱动程序的调试日志

下载适用于您的 Windows、Linux 或 macOS 计算机的 Athena ODBC 2.x 驱动程序。然后，为您的操作系统（OS）创建数据来源。

要激活 Windows 计算机的调试日志，请完成以下步骤：

1. 从 Windows 的“开始”菜单中选择 ** ODBC 数据来源**。
2. 在 **ODBC 数据来源管理器中，**选择您的数据来源名称。
3. 选择配置，然后选择日志记录选项。
4. 使用以下参数：
   对于日志级别，选择日志级别： 1。
   对于日志路径，选择您的 Windows 计算机上的路径。
   （可选）要激活 AWS 开发工具包日志，请选择启用 AWS Logger。
5. 选择确定。

要激活 macOS 计算机的调试日志，请完成以下步骤：

1. 在 macOS 上安装 ODBC 数据连接器。
2. 在以下位置为您的处理器打开 ** odbc.ini**：
   英特尔处理器：/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 driver