Partager via


Utiliser MongoDB Shell pour se connecter à Azure Cosmos DB for MongoDB (vCore)

S’APPLIQUE À : MongoDB vCore

MongoDB Shell (mongosh) est un environnement JavaScript et Node.js pour interagir avec les déploiements MongoDB. Il s'agit d'un outil communautaire populaire permettant de tester des requêtes et d'interagir avec les données de votre base Azure Cosmos DB for MongoDB.

Prérequis

  • Un cluster Azure Cosmos DB pour MongoDB (architecture vCore) déjà existant.

  • Une version installée de MongoDB Shell à partir du site de la communauté.

  • Configuration des variables d'environnement nécessaires à la post-installation pour votre système d'exploitation.

  • Paramètres du pare-feu qui permettent à la machine de se connecter. Suivez les instructions pour configurer le pare-feu pour Azure Cosmos DB.

    Vous pouvez choisir d'autoriser les requêtes provenant de votre adresse IP actuelle, de services cloud ou de machines virtuelles (plages IP spécifiques).

    Animation qui montre une mise à jour des paramètres du pare-feu pour Azure Cosmos DB for MongoDB dans l'architecture vCore.

    Si vous ouvrez accidentellement tous les ports, vous êtes averti avant d'enregistrer les modifications.

Se connecter en utilisant MongoDB Shell

Pour ajouter votre cluster Azure Cosmos DB à MongoDB Shell, effectuez les étapes suivantes :

  1. Récupérez les informations de connexion de votre instance de cluster Azure Cosmos DB for MongoDB (vCore) à l’aide de ces instructions.

    Animation qui montre les sélections pour obtenir une chaîne de connexion.

  2. Connectez en utilisant l’une de ces méthodes :

    • Saisissez le mot de passe dans l'invite Mongo Shell. Votre chaîne de connexion ressemble à cet exemple :

      "mongodb+srv://<username>@<servername>.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000"
      

      La commande ressemble à cet exemple :

      mongosh "mongodb+srv://testuser@mongodbvcoretesting.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000
      

      Animation qui montre comment se connecter en entrant un mot de passe.

      Une fois que vous avez fourni le mot de passe et que vous avez réussi à vous authentifier, l'avertissement suivant s'affiche : « Ce serveur ou service semble être une émulation de MongoDB ». Vous pouvez l’ignorer. Cet avertissement est généré, car la chaîne de connexion contient cosmos.azure. Azure Cosmos DB est une plateforme en tant qu’offre de service (PaaS) Azure native.

    • Fournissez le mot de passe comme partie intégrante de la chaîne de connexion. Le format ressemble à cet exemple :

      mongosh "mongodb+srv://<SERVERNAME>.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000" --username "<USER>" -password "<PASSWORD>"
      

      La commande ressemble à cet exemple :

      mongosh "mongodb+srv://mongodbvcoretesting.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000" --username "testuser" -password "******"
      

      Capture d'écran montrant un mot de passe faisant partie d'une chaîne de connexion.

Étape suivante