

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Connectez-vous à Amazon DocumentDB depuis Microsoft Power BI Desktop
<a name="connect-odbc-power-bi"></a>

**Topics**
+ [Conditions préalables](#odbc-power-bi-prerequisites)
+ [Ajout d'un connecteur personnalisé Microsoft Power BI Desktop](#odbc-adding-power-bi)
+ [Connexion à l'aide du connecteur personnalisé Amazon DocumentDB](#odbc-connect-custom-connector)
+ [Configuration de Microsoft Power BI Gateway](#odbc-power-bi-gw)

## Conditions préalables
<a name="odbc-power-bi-prerequisites"></a>

Avant de commencer, assurez-vous que le pilote ODBC Amazon DocumentDB est correctement installé.

## Ajout d'un connecteur personnalisé Microsoft Power BI Desktop
<a name="odbc-adding-power-bi"></a>

Copiez le `AmazonDocumentDBConnector.mez` fichier `<User>\Documents\Power BI Desktop\Custom Connectors\` dans le dossier (ou dans ce dossier `<User>\OneDrive\Documents\Power BI Desktop\Custom Connectors` si vous l'utilisez OneDrive). Cela permettra à Power BI d'accéder à un connecteur personnalisé. Vous pouvez obtenir le connecteur à Power BI Desktop [ ici](https://github.com/aws/amazon-documentdb-odbc-driver/releases). Redémarrez Power BI Desktop pour vous assurer que le connecteur est chargé.

**Note**  
Le connecteur personnalisé prend uniquement en charge le nom d'utilisateur et le mot de passe Amazon DocumentDB pour l'authentification.

## Connexion à l'aide du connecteur personnalisé Amazon DocumentDB
<a name="odbc-connect-custom-connector"></a>

1. Sélectionnez Amazon DocumentDB (bêta) dans ** ** Get Data, puis sélectionnez ** Connect**. Si vous recevez un avertissement concernant l'utilisation d'un service tiers, choisissez ** Continuer**.  
![L'option d'interface Get Data avec Amazon DocumentDB (bêta) est mise en évidence.](http://docs.aws.amazon.com/fr_fr/documentdb/latest/devguide/images/get-data-1.png)

1. Entrez toutes les informations nécessaires pour vous connecter à votre cluster Amazon DocumentDB, puis choisissez ** OK ** :  
![Formulaire avec champs de saisie des détails de connexion pour un cluster Amazon DocumentDB.](http://docs.aws.amazon.com/fr_fr/documentdb/latest/devguide/images/docdb-form-1.png)
**Note**  
Selon la configuration du nom de source de données (DSN) de votre pilote ODBC, l'écran des détails de la connexion SSH peut ne pas s'afficher si vous avez déjà fourni les informations nécessaires dans les paramètres DSN.

1. Choisissez le mode de connectivité des données :
   + **Importer ** : charge toutes les données et stocke les informations sur le disque. Les données doivent être actualisées et rechargées pour afficher les mises à jour des données.
   + **Requête directe ** : ne charge pas les données, mais effectue des requêtes en direct sur les données. Cela signifie qu'il n'est pas nécessaire d'actualiser et de recharger les données pour afficher les mises à jour des données.  
![Interface affichant les options du mode de connectivité des données pour DocumentDB.](http://docs.aws.amazon.com/fr_fr/documentdb/latest/devguide/images/data-connectivity-1.png)
**Note**  
Si vous utilisez un très grand ensemble de données, l'importation de toutes les données peut prendre plus de temps.

1. S'il s'agit de la première connexion à cette source de données, sélectionnez le type d'authentification et saisissez vos informations d'identification lorsque vous y êtes invité. Choisissez ensuite ** Connect ** :  
![Interface d'authentification affichant les champs de saisie pour les informations d'identification du nom d'utilisateur et du mot de passe.](http://docs.aws.amazon.com/fr_fr/documentdb/latest/devguide/images/docdb-credentials-1.png)

1. Dans la ** boîte de dialogue du ** Navigateur, sélectionnez les tables de base de données souhaitées, puis choisissez ** Charger ** pour charger les données ou ** Transformer les données ** pour poursuivre la transformation des données.  
![Interface de navigation affichant la liste des tables de base de données parmi lesquelles choisir. Les boutons Charger et Transformer les données se trouvent en bas à droite.](http://docs.aws.amazon.com/fr_fr/documentdb/latest/devguide/images/navigator-1.png)
**Note**  
Les paramètres de votre source de données sont enregistrés une fois que vous vous connectez. Pour les modifier, sélectionnez ** Transformer les données ** > Paramètres de la source de ** données**.

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

**Prérequis :**
+ Assurez-vous que le connecteur personnalisé fonctionne avec Power BI Gateway.
+ Assurez-vous que le DSN ODBC est créé dans les sources de données ODBC de l'**onglet ** Système de la machine sur laquelle Power BI Gateway est installé.

Si vous utilisez la fonctionnalité de tunnel SSH interne, le fichier `known_hosts` doit se trouver là où le compte de service Power BI y a accès.

![L'interface des propriétés known_hosts affichant les autorisations pour. PBIEgwService](http://docs.aws.amazon.com/fr_fr/documentdb/latest/devguide/images/ssh-known-hosts-1.png)


**Note**  
Cela s'applique également à tous les fichiers dont vous pourriez avoir besoin pour établir une connexion à votre cluster Amazon DocumentDB, tels qu'un fichier de certificat d'autorité de certification (CA) (fichier pem). 