

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 Microsoft Power BI Desktop
<a name="connect-odbc-power-bi"></a>

**Topics**
+ [Prerequisiti](#odbc-power-bi-prerequisites)
+ [Aggiungere un connettore personalizzato Microsoft Power BI Desktop](#odbc-adding-power-bi)
+ [Connessione tramite il connettore personalizzato Amazon DocumentDB](#odbc-connect-custom-connector)
+ [Configurazione di Microsoft Power BI Gateway](#odbc-power-bi-gw)

## Prerequisiti
<a name="odbc-power-bi-prerequisites"></a>

Prima di iniziare, assicurati che il driver Amazon DocumentDB ODBC sia installato correttamente.

## Aggiungere un connettore personalizzato Microsoft Power BI Desktop
<a name="odbc-adding-power-bi"></a>

Copia il `AmazonDocumentDBConnector.mez` file nella `<User>\Documents\Power BI Desktop\Custom Connectors\` cartella (o in `<User>\OneDrive\Documents\Power BI Desktop\Custom Connectors` caso di utilizzo OneDrive). Ciò consentirà a Power BI di accedere al connettore personalizzato. Puoi ottenere il connettore per Power BI Desktop [qui](https://github.com/aws/amazon-documentdb-odbc-driver/releases). Riavvia Power BI Desktop per assicurarti che il connettore sia caricato.

**Nota**  
Il connettore personalizzato supporta solo nome utente e password di Amazon DocumentDB per l'autenticazione.

## Connessione tramite il connettore personalizzato Amazon DocumentDB
<a name="odbc-connect-custom-connector"></a>

1. **Seleziona Amazon DocumentDB (Beta) da **Get Data** e scegli Connect.** Se ricevi un avviso per l'utilizzo di un servizio di terze parti, scegli **Continua**.  
![L'opzione Get Data interface with Amazon DocumentDB (Beta) è evidenziata.](http://docs.aws.amazon.com/it_it/documentdb/latest/devguide/images/get-data-1.png)

1. **Inserisci tutte le informazioni necessarie per connetterti al tuo cluster Amazon DocumentDB, quindi scegli OK:**  
![Modulo con campi di immissione dei dettagli di connessione per un cluster Amazon DocumentDB.](http://docs.aws.amazon.com/it_it/documentdb/latest/devguide/images/docdb-form-1.png)
**Nota**  
A seconda della configurazione del Data Source Name (DSN) del driver ODBC, la schermata dei dettagli della connessione SSH potrebbe non essere visualizzata se sono già state fornite le informazioni necessarie nelle impostazioni DSN.

1. Scegliete la modalità di connettività dati:
   + **Importa**: carica tutti i dati e archivia le informazioni su disco. I dati devono essere aggiornati e ricaricati per mostrare gli aggiornamenti dei dati.
   + **Direct Query**: non carica i dati, ma esegue interrogazioni in tempo reale sui dati. Ciò significa che non è necessario aggiornare e ricaricare i dati per mostrare gli aggiornamenti dei dati.  
![Interfaccia che mostra le opzioni della modalità di connettività dati per DocumentDB.](http://docs.aws.amazon.com/it_it/documentdb/latest/devguide/images/data-connectivity-1.png)
**Nota**  
Se si utilizza un set di dati molto grande, l'importazione di tutti i dati potrebbe richiedere un periodo di tempo più lungo.

1. Se è la prima volta che ti connetti a questa fonte di dati, seleziona il tipo di autenticazione e inserisci le credenziali quando richiesto. Quindi scegli **Connect**:  
![Interfaccia di autenticazione che mostra i campi di input per le credenziali di nome utente e password.](http://docs.aws.amazon.com/it_it/documentdb/latest/devguide/images/docdb-credentials-1.png)

1. Nella finestra di dialogo **Navigator**, selezionate le tabelle del database desiderate, quindi scegliete **Carica per caricare** i dati o **Trasforma dati per continuare a trasformare i dati**.  
![Interfaccia Navigator che mostra l'elenco delle tabelle del database tra cui scegliere. I pulsanti Carica e Trasforma i dati si trovano in basso a destra.](http://docs.aws.amazon.com/it_it/documentdb/latest/devguide/images/navigator-1.png)
**Nota**  
Le impostazioni delle sorgenti dati vengono salvate una volta effettuata la connessione. Per modificarle, seleziona **Trasforma dati** **> Impostazioni dell'origine dati**.

## Configurazione di Microsoft Power BI Gateway
<a name="odbc-power-bi-gw"></a>

**Prerequisiti:**
+ Assicurati che il connettore personalizzato funzioni con Power BI Gateway.
+ Assicurati che il DSN ODBC sia creato nelle sorgenti dati ODBC nella scheda **Sistema** sul computer in cui è installato Power BI Gateway.

Se si utilizza la funzionalità di tunnel SSH interno, il file `known_hosts` deve trovarsi dove l'account del servizio Power BI può accedervi.

![L'interfaccia delle proprietà known_hosts che mostra le autorizzazioni per. PBIEgwService](http://docs.aws.amazon.com/it_it/documentdb/latest/devguide/images/ssh-known-hosts-1.png)


**Nota**  
Questo vale anche per qualsiasi file di cui potresti aver bisogno per stabilire una connessione al tuo cluster Amazon DocumentDB, ad esempio un file di certificato dell'autorità di certificazione (CA) (file pem). 