Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Connect ad Amazon DocumentDB da Tableau Desktop
<a name="connect-jdbc-tableau"></a>

**Topics**
+ [Aggiungere il driver JDBC di Amazon DocumentDB](#connect-jdbc-tableau-adddriver)
+ [Connessione ad Amazon DocumentDB tramite Tableau - SSH Tunnel](#connect-jdbc-tableau-ssh)

## Aggiungere il driver JDBC di Amazon DocumentDB
<a name="connect-jdbc-tableau-adddriver"></a>

Per connetterti ad Amazon DocumentDB da Tableau Desktop, devi scaricare e installare il driver JDBC Amazon DocumentDB e il connettore Tableau di Amazon DocumentDB.

1. Scarica il file JAR del driver JDBC di Amazon DocumentDB dal [repository Amazon DocumentDB JDBC Driver](https://github.com/aws/amazon-documentdb-jdbc-driver/releases) e copialo in una di queste directory in base al tuo sistema operativo:
   + *Windows -* `C:\Program Files\Tableau\Drivers`
   + *macOS -* `~/Library/Tableau/Drivers`

1. *Scarica il connettore Tableau DocumentDB (un file TACO) dal [sito Web di Tableau Exchange](https://exchange.tableau.com/products/821) e copialo nella tua directory My Tableau. Repository/Connectors *
   + *Windows -* `C:\Users\[user]\Documents\My Tableau Repository\Connectors`
   + *macOS -* `/Users/[user]/Documents/My Tableau Repository/Connectors`

Per ulteriori informazioni, consulta la documentazione di [Tableau](https://tableau.github.io/connector-plugin-sdk/docs/run-taco).

**Nota**  
[Se utilizzi certificati CA più recenti, assicurati di aggiornare il driver JDBC alla versione 1.4.5 (disponibile in questo repository). AWS GitHub ](https://github.com/aws/amazon-documentdb-jdbc-driver/releases/tag/v1.4.5)

## Connessione ad Amazon DocumentDB tramite Tableau - SSH Tunnel
<a name="connect-jdbc-tableau-ssh"></a>

Per connetterti a Tableau da una macchina client esterna al VPC del cluster DocumentDB, devi configurare un tunnel SSH prima di seguire i passaggi seguenti:

1. Avvia l'applicazione Tableau Desktop.

1. Passa a **Connect** > **A un server** > **Altro**. 

1.  Scegli **Amazon DocumentDB di Amazon Web Services in Connettori** **installati**.  
![L'interfaccia Connect su Tableau Desktop mostra il sottomenu Altro... nella sezione Verso un server. L'opzione Amazon DocumentDB è evidenziata nel sottomenu Installed Connectors.](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/jdbc/tableau-choose-docdb.png)

**Connessione ad Amazon DocumentDB tramite Tableau - Tunnel SSH esterno**

1. ****Inserisci i parametri di connessione richiesti **Nome host, **Porta**, **Database**, Nome** utente e Password.**** I parametri di connessione nell'esempio seguente sono equivalenti alla stringa di connessione JDBC: 

   `jdbc:documentdb://localhost:27019/test? tls=true&tlsAllowInvalidHostnames=true&scanMethod=random&scanLimit=1000&loginTimeoutSec=0&readPreference=primary&retryReads=true&schemaName=_default`con i parametri nome utente e password passati separatamente in una raccolta di proprietà. Per ulteriori informazioni sui parametri della stringa di connessione, consulta la documentazione su github del [driver JDBC di Amazon DocumentDB](https://github.com/aws/amazon-documentdb-jdbc-driver/blob/develop/src/markdown/setup/connection-string.md).   
![Scheda Generale nell'interfaccia del connettore Amazon DocumentDB che mostra i campi nome host, porta, database, nome utente e password.](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/jdbc/tableau-connect.png)

1. (Facoltativo) Sono disponibili opzioni più avanzate nella scheda **Avanzate**.  
![Scheda Advanced nell'interfaccia del connettore Amazon DocumentDB che mostra opzioni di connessione aggiuntive.](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/jdbc/tableau-advanced.png)

1. Selezionare **Sign in (Accedi)**.

**Connessione ad Amazon DocumentDB tramite Tableau - Tunnel SSH interno**
**Nota**  
Se preferisci non configurare il tunnel SSH utilizzando un terminale, puoi utilizzare la GUI di Tableau per specificare i dettagli dell'istanza EC2 che il driver JDBC utilizzerà intrinsecamente per creare un tunnel SSH. 

1. Nella scheda **Avanzate**, scegli l'opzione **Abilita** tunnel SSH per esaminare ulteriori proprietà.  
![Scheda Advanced nell'interfaccia del connettore Amazon DocumentDB con Enable SSH Tunnel selezionato e campi di input SSH aggiuntivi visualizzati.](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/jdbc/tableau-advanced-Enablessh.png)

1. **Inserisci l'**utente SSH**, il **nome host SSH** e il file di chiave privata SSH.** 

1. (Facoltativo) È possibile disabilitare l'opzione **SSH Strict Host Key Check**, che ignora il controllo della chiave host rispetto a un file hosts noto.
**Nota**  
La disabilitazione di questa opzione è meno sicura in quanto può portare a un attacco. [man-in-the-middle](https://en.wikipedia.org/wiki/Man-in-the-middle_attack)  
![Scheda Advanced nell'interfaccia del connettore Amazon DocumentDB con l'opzione SSH Strict Host Key Check disabilitata.](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/jdbc/tableau-advanced-sshhostkeycheck.png)

1. **Inserisci i parametri richiesti: **nome host**, **porta**, **database**, nome **utente e password**.**
**Nota**  
Assicurati di utilizzare l'endpoint del cluster DocumentDB e non localhost quando usi l'opzione tunnel SSH interno.  
![Scheda Generale nell'interfaccia del connettore Amazon DocumentDB che mostra i campi nome host, porta, database, nome utente e password.](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/jdbc/tableau-hostname.png)

1. Selezionare **Sign in (Accedi)**.