如何使用 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

  如果您将 Amazon VPC 端点用于私有 DNS 服务器，请将您的 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. 在您的操作系统的以下 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。

AthenaJDBC_connection 和 AthenaJDBC_Driver 日志文件现在会在 Datasources 文件夹中生成。