Connexion à un cluster Amazon DocumentDB depuis Studio 3T

Studio 3T est une interface graphique et un IDE populaires pour les développeurs et les ingénieurs de données qui travaillent avec MongoDB. Il offre plusieurs fonctionnalités puissantes : des vues arborescentes, tabulaires et JSON de vos données, une importation/exportation facile au format CSV, JSON, SQL et BSON/MongoDump, une option de requête flexible, une drag-and-drop interface utilisateur visuelle, un shell mongo intégré avec auto-complétion, un éditeur de pipeline d'agrégation et un support de requêtes SQL.

Prérequis

• Si vous ne possédez pas encore de cluster Amazon DocumentDB utilisant Amazon EC2 comme hôte bastion/jump, suivez les instructions pour vous connecter à Amazon EC2.

• Si vous ne possédez pas Studio 3T, téléchargez-le et installez-le.

Connect avec Studio 3T

1. Choisissez Connect dans le coin supérieur gauche de la barre d'outils.

   

2. Choisissez Nouvelle connexion dans le coin supérieur gauche de la barre d'outils.

   

3. Dans l'onglet Serveur, dans le champ Serveur, entrez les informations du point de terminaison du cluster.

   

   Note

   Vous ne trouvez pas le point de terminaison de votre cluster ? Il vous suffit de suivre les étapes indiquées ici.

4. Choisissez l'onglet Authentification et sélectionnez Legacy dans le menu déroulant du mode d'authentification.

   

5. Entrez votre nom d'utilisateur et vos informations d'identification dans les champs Nom d'utilisateur et Mot de passe.

6. Choisissez l'onglet SSL et cochez la case Utiliser le protocole SSL pour vous connecter.

   

7. Choisissez Utiliser votre propre fichier racine CA. Ajoutez ensuite le certificat Amazon DocumentDB (vous pouvez ignorer cette étape si le protocole SSL est désactivé sur votre cluster DocumentDB). Cochez la case pour autoriser les noms d'hôtes non valides.

   

   Note

   Vous n'avez pas le certificat ? Vous pouvez le télécharger à l'aide de la commande suivante :

   wget https://truststore.pki.rds.amazonaws.com/global/global-bundle.pem

8. Si vous vous connectez depuis une machine cliente extérieure à Amazon VPC, vous devez créer un tunnel SSH. Vous allez le faire dans l'onglet SSH.

   1. Cochez la case Utiliser le tunnel SSH et saisissez l'adresse SSH dans le champ Adresse SSH. Il s'agit du DNS public (IPV4) de votre instance. Vous pouvez obtenir cette URL depuis votre console de gestion Amazon EC2.

   2. Entrez votre nom d'utilisateur. Il s'agit du nom d'utilisateur de votre instance Amazon EC2

   3. Pour le mode d'authentification SSH, sélectionnez Clé privée. Dans le champ Clé privée, cliquez sur l'icône de recherche de fichiers pour localiser et choisir la clé privée de votre instance Amazon EC2. Il s'agit du fichier .pem (paire de clés) que vous avez enregistré lors de la création de votre instance dans la console Amazon EC2.

   4. Si vous utilisez un ordinateur client Linux/macOS, vous devrez peut-être modifier les autorisations de votre clé privée à l'aide de la commande suivante :

      chmod 400 /fullPathToYourPemFile/<yourKey>.pem

   

   Note

   Cette instance Amazon EC2 doit se trouver dans le même VPC Amazon et le même groupe de sécurité que votre cluster DocumentDB. Vous pouvez obtenir l'adresse SSH, le nom d'utilisateur et la clé privée depuis votre console de gestion Amazon EC2.

9. Testez maintenant votre configuration en cliquant sur le bouton Tester la connexion.

   

10. Une fenêtre de diagnostic doit charger une barre verte pour indiquer que le test a réussi. Choisissez maintenant OK pour fermer la fenêtre de diagnostic.

    

11. Choisissez Enregistrer pour enregistrer votre connexion en vue d'une utilisation future.

    

12. Sélectionnez maintenant votre cluster et choisissez Connect.

    

Félicitations ! Vous êtes désormais connecté avec succès à votre cluster Amazon DocumentDB via Studio 3T.