

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 à l'aide de DataGrip
<a name="data-grip-connect"></a>

[DataGrip](https://www.jetbrains.com/help/datagrip/documentdb.html)est un puissant environnement de développement intégré (IDE) qui prend en charge différents systèmes de base de données, notamment Amazon DocumentDB. Cette section explique les étapes à suivre pour vous connecter à votre cluster Amazon DocumentDB à l'aide d'une interface graphique DataGrip, ce qui vous permet de gérer et d'interroger facilement vos données.

## Conditions préalables
<a name="data-grip-prerequisites"></a>
+ DataGrip IDE installé sur votre machine. Vous pouvez le télécharger depuis [JetBrains](https://www.jetbrains.com/datagrip/download/#section=windows).
+ Une instance Amazon EC2 exécutée dans le même VPC que votre cluster Amazon DocumentDB. Vous allez utiliser cette instance pour établir un tunnel sécurisé entre votre machine locale et Amazon DocumentDBCluster. Suivez les instructions pour savoir comment procéder[Connectez-vous à l'aide d'Amazon EC2](connect-ec2.md).
+ Alternative à une instance Amazon EC2, à une connexion VPN ou si vous accédez déjà à votre AWS infrastructure à l'aide d'un VPN sécurisé. Si vous préférez cette option, suivez les instructions pour [accéder en toute sécurité à Amazon DocumentDB](https://aws.amazon.com/blogs/database/securely-access-amazon-documentdb-with-mongodb-compatibility-locally-using-aws-client-vpn/) à l'aide de. AWS Client VPN

## Connect en utilisant DataGrip
<a name="data-grip-connect-steps"></a>

1. Lancez DataGrip sur votre ordinateur et créez un **nouveau projet**.  
![DataGrip écran de bienvenue avec l'option Nouveau projet surlignée.](http://docs.aws.amazon.com/fr_fr/documentdb/latest/devguide/images/welcome.png)

1. Ajoutez une nouvelle source de données en utilisant l'une des méthodes suivantes :

   1. Dans le menu principal, accédez à **Fichier — Nouveau — Source de données** et sélectionnez **DocumentDB**

   1. Dans l'**explorateur de base** de données, choisissez la nouvelle icône (**\+**) dans la barre d'outils. Accédez à la **source de données** et sélectionnez **DocumentDB**.  
![La liste déroulante pour + affiche le sous-menu Source de données. DocumentDB est sélectionné dans ce sous-menu.](http://docs.aws.amazon.com/fr_fr/documentdb/latest/devguide/images/explorer.png)

1. Sur la page **Sources de données** de l'onglet **Général**, vérifiez s'il existe un lien **Télécharger les fichiers de pilotes manquants** en bas de la zone des paramètres de connexion. Cliquez sur ce lien pour télécharger les pilotes nécessaires pour interagir avec une base de données. Pour un lien de téléchargement direct, reportez-vous aux pilotes [JetBrains JDBC.](https://www.jetbrains.com/datagrip/jdbc-drivers/)  
![Interface des sources de données et des pilotes avec le lien Télécharger les fichiers de pilotes manquants surligné.](http://docs.aws.amazon.com/fr_fr/documentdb/latest/devguide/images/missing-driver.png)

1. Dans l'onglet **Général**, spécifiez les détails de la connexion :

   1. Dans le champ **Host**, spécifiez le point de terminaison du cluster Amazon DocumentDB.

   1. **Le port** est déjà défini sur 27017. Modifiez-le si votre cluster a été déployé sur un autre port.

   1. Pour **Authentification**, choisissez **Utilisateur et mot de passe**.

   1. Entrez votre nom d'utilisateur et votre mot de passe.

   1. Le champ **Base de données** est facultatif. Vous pouvez spécifier la base de données à laquelle vous souhaitez vous connecter.

   1. Le champ **URL** se complète automatiquement au fur et à mesure que vous ajoutez les informations précédentes.  
![Champs d'hôte, de port, d'authentification, de base de données et d'URL dans l'onglet Général de l'interface Sources de données et pilotes.](http://docs.aws.amazon.com/fr_fr/documentdb/latest/devguide/images/connection.png)

1. Dans l'**SSH/SSL**onglet, activez **Utiliser le tunnel SSH**, puis cliquez sur l'icône pour ouvrir la boîte de dialogue de **configuration SSH**. Entrez les informations suivantes :

   1. dans le champ **Host**, entrez le nom d'hôte de votre instance Amazon EC2.

   1. Entrez le nom d'utilisateur et le mot de passe de votre instance Amazon EC2.

   1. Pour **Type d'authentification**, choisissez **Key pair**.

   1. Entrez votre **fichier de clé privée**.
**Note**  
Si vous utilisez l'option VPN, il n'est pas nécessaire de configurer le tunnel SSH.  
![L' SSH/SSL onglet de l'interface Sources de données et pilotes avec Utiliser le tunnel SSH sélectionné et l'icône de configuration SSH surlignée. L'icône ouvre l'interface de configuration SSH affichée.](http://docs.aws.amazon.com/fr_fr/documentdb/latest/devguide/images/ssh-tunnel.png)

1. Dans l'**SSH/SSL**onglet, activez **Utiliser le protocole SSL**. Dans le champ **Fichier CA**, entrez l'emplacement du `global-bundle.pem` fichier sur votre ordinateur. Pour **Mode**, laissez l'option **Exiger**.
**Note**  
Vous pouvez télécharger le certificat à partir de cet emplacement ou à l'aide de cette commande : wget [https://truststore.pki.rds.amazonaws.com/global/global-bundle.pem](https://truststore.pki.rds.amazonaws.com/global/global-bundle.pem)
**Note**  
Si vous vous connectez au cluster élastique Amazon DocumentDB, il n'est pas nécessaire de spécifier le fichier CA. Laissez l'option **Utiliser SSL** cochée et toutes les autres options à leurs valeurs par défaut.  
![SSH/SSL onglet dans l'interface Sources de données et pilotes avec les paramètres SSL activés.](http://docs.aws.amazon.com/fr_fr/documentdb/latest/devguide/images/use-ssl.png)

1. Dans l'onglet **Schémas**, choisissez **Toutes les bases de données** ou entrez le filtre « \* : \* » dans le champ **Modèle de schéma**. Choisissez **Tester la connexion** pour tester la connexion.  
![L'onglet Schémas de l'interface Sources de données et pilotes avec l'option Toutes les bases de données sélectionnée. Un message de réussite apparaît au-dessus du lien Tester la connexion.](http://docs.aws.amazon.com/fr_fr/documentdb/latest/devguide/images/schemas.png)

1. Une fois la connexion testée avec succès, cliquez **sur OK** pour enregistrer la configuration de la source de données.

## DataGrip features
<a name="data-grip-features"></a>

DataGrip propose différentes fonctionnalités pour vous aider à travailler efficacement avec Amazon DocumentDB :
+ **Éditeur SQL** : écrivez et exécutez des SQL-like requêtes sur vos collections DocumentDB à l'aide de l'éditeur SQL dans. DataGrip
+ **Générateur de requêtes visuel** : utilisez le générateur de requêtes visuel pour créer des requêtes graphiquement sans écrire de code SQL.
+ **Gestion des schémas** — Gérez facilement le schéma de votre base de données, notamment en créant, en modifiant et en supprimant des collections.
+ **Visualisation des données : visualisez** et analysez vos données à l'aide des différents outils de visualisation disponibles dans DataGrip.
+ **Exportation et importation de données** : transférez des données entre Amazon DocumentDB et d'autres bases de données à l'aide des fonctionnalités DataGrip d'exportation et d'importation.

Consultez la [DataGrip documentation](https://www.jetbrains.com/datagrip/features/) officielle pour obtenir des fonctionnalités plus avancées et des conseils sur l'utilisation d'Amazon DocumentDB et d'autres systèmes de base de données.