如何使用 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. 請在以下與您作業系統（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。

現在，AthenaJDBC_connection 和 AthenaJDBC_Driver 日誌檔案會產生在 Datasources 資料夾中。