Como usar os drivers do Athena para solucionar problemas de conectividade com o Tableau?

Resolução

Resolver problemas relacionados ao driver

Se você tiver problemas relacionados ao driver, receberá uma mensagem de erro semelhante à seguinte:

"The drivers required to connect to the data source are not installed. No Suitable driver Installed. Error code: AA76601F"

Esse erro ocorre quando você não usa um driver JDBC do Athena adequado ou não o baixa no local correto.

Para solucionar esse problema, realize as etapas a seguir:

1. Faça o download da versão mais recente do driver JDBC JAR do Athena com um AWS SDK incluído.
2. Salve o driver JDBC do Athena no local correto do driver do Tableau:
   Para Windows, salve o arquivo .jar JDBC do Athena na pasta C:\Program Files\Tableau\Drivers.
   Para macOS, salve o arquivo .jar JDBC do Athena na pasta ~/Library/Tableau/Drivers.
   Observação: não adicione vários arquivos .jar. Caso contrário, poderão ocorrer problemas relacionados ao driver.
3. Reinicie o Tableau e conecte-se ao Athena.

Resolver tempos limite de conexão

Em caso de tempo limite de conexão, você receberá uma mensagem de erro semelhante à seguinte:

"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."

Esse erro ocorre quando não há conexão entre o driver que está no host instalado e o Athena.

Observação: nos comandos a seguir, substitua aa-example-1 pela sua região da AWS. Para os comandos de endpoint do Amazon Virtual Private Cloud (Amazon VPC), substitua 1234567890abcdef0 pelo seu ID de endpoint da VPC.

Para resolver esse problema, execute as seguintes ações:

• Abra as portas 443 e 444. O Athena usa a porta 443 para se conectar ao host, e a API de streaming do Athena usa a porta 444 para transmitir os resultados da consulta.

• Execute os seguintes comandos em seu sistema operacional (SO) para testar a conectividade do endpoint com as portas 443 e 444 da máquina host do driver:
  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

  Se você usa um endpoint da Amazon VPC para um servidor DNS privado, adicione o ID do endpoint da VPC ao início do endpoint. Em seguida, adicione o subdomínio vpce.
  Endpoint da VPC no Windows:

  telnet vpce-1234567890abcdef0.athena.aa-example-1.vpce.amazonaws.com 443
  
  telnet vpce-1234567890abcdef0.athena.aa-example-1.vpce.amazonaws.com 444

  Endpoint da VPC no macOS:

  nc -v vpce-1234567890abcdef0.athena.aa-example-1.vpce.amazonaws.com 443
  
  nc -v vpce-1234567890abcdef0.athena.aa-example-1.vpce.amazonaws.com 444

• Use o ID correto da chave de acesso do usuário e a chave de acesso secreta do AWS Identity and Access Management (AWS IAM). Além disso, adicione as permissões necessárias para o Amazon Simple Storage Service (Amazon S3), Athena e AWS Glue.

Problemas relacionados à consulta de depuração e à conexão

Para ativar os logs do driver JDBC do Athena para Tableau, conclua as seguintes etapas:

1. Crie um arquivo athena.properties na seguinte pasta Datasources para seu sistema operacional:
   Para Windows, use a pasta C:\Users\[YourUsername]\Documents\My Tableau Repository\Datasources.
   Para macOS, use a pasta ~/Documents/My Tableau Repository/Datasources.

2. Abra o arquivo de propriedades e adicione o seguinte:

   LogLevel=6
   LogPath=D:\\test\
   UseAwsLogger=1

3. Salve o arquivo e feche o Tableau.

4. Conecte-se ao Athena.

Os arquivos de log AthenaJDBC_connection e AthenaJDBC_Driver agora são gerados na pasta Datasources.