Come posso utilizzare i driver Athena per risolvere i problemi di connettività di Tableau?

Risoluzione

Risolvi i problemi relativi al driver

Se riscontri problemi relativi al driver, ricevi un messaggio di errore simile al seguente:

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

L'errore si verifica quando non utilizzi un driver JDBC Athena adatto o non lo scarichi nella posizione corretta.

Per risolvere il problema, completa i seguenti passaggi:

1. Scarica l'ultima versione del JAR del driver JDBC Athena con un AWS SDK fornito.
2. Salva il driver JDBC Athena nella posizione corretta del driver di Tableau:
   Per Windows, salva il file .jar del driver JDBC Athena nella cartella C:\Program Files\Tableau\Drivers.
   Per macOS, salva il file .jar del driver JDBC Athena nella cartella ~/Library/Tableau/Drivers.
   Nota: non aggiungere più file .jar. Se aggiungi più file .jar, potrebbero verificarsi problemi relativi ai driver.
3. Riavvia Tableau, quindi connettiti ad Athena.

Risolvi i timeout di connessione

Se si verificano timeout di connessione, ricevi un messaggio di errore simile al seguente:

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

L'errore si verifica quando non c'è connessione tra il driver presente nell'host installato e Athena.

Nota: nei seguenti comandi, sostituisci aa-example-1 con la tua Regione AWS. Per i comandi degli endpoint Amazon Virtual Private Cloud (Amazon VPC), sostituisci 1234567890abcdef0 con l'ID del tuo endpoint VPC.

Per risolvere il problema, intraprendi le seguenti azioni:

• Apri le porte 443 e 444. Athena utilizza la porta 443 per connettersi all'host e l'API di streaming Athena utilizza la porta 444 per lo streaming dei risultati delle query.

• Esegui questi comandi in base al sistema operativo (OS) per verificare la connettività degli endpoint alle porte 443 e 444 dal computer host del 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 utilizzi un endpoint Amazon VPC per un server DNS privato, aggiungi l'ID del tuo endpoint VPC all'inizio dell'endpoint. Quindi aggiungi il sottodominio vpce.
  Endpoint VPC in Windows:

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

  Endpoint VPC in 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

• Utilizza l'ID della chiave di accesso utente e la chiave di accesso segreta di AWS Identity and Access Management (AWS IAM) corretti. Inoltre, aggiungi le autorizzazioni richieste per Amazon Simple Storage Service (Amazon S3), Athena e AWS Glue.

Risolvi i problemi relativi alla query e alla connessione

Per attivare i log del driver JDBC Athena per Tableau, completa i seguenti passaggi:

1. Crea un file athena.properties nella seguente cartella Datasources per il sistema operativo in uso:
   Per Windows, utilizza la cartella C:\Users\[YourUsername]\Documents\My Tableau Repository\Datasources.
   Per macOS, utilizza la cartella ~/Documents/My Tableau Repository/Datasources.

2. Apri il file delle proprietà e aggiungi quanto segue:

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

3. Salva il file, quindi chiudi Tableau.

4. Connettiti ad Athena.

A questo punto, nella cartella Datasources vengono generati i file di log AthenaJDBC_connection e AthenaJDBC_Driver.