IBM Cloud Docs
Connexion avec le shell MongoDB

Connexion avec le shell MongoDB

Vous pouvez accéder à votre base de données MongoDB à partir d'un client de ligne de commande, ce qui vous permet d'interagir directement avec les structures de données qui sont créées dans la base de données et de les surveiller. Utilisez-le pour interroger et mettre à jour des données, ainsi que pour effectuer des opérations d'administration et surveiller les performances.

Installation

L'interpréteur de commandes MongoDB est disponible dans le cadre de la distribution MongoDB. Téléchargez-le ici.

Connexion en cours

Les chaînes de connexion sont affichées dans le panneau Noeuds finaux de la présentation de votre déploiement et peuvent aussi être extraites du plug-in CLI Cloud Databases, et de l'API.

Les informations dont le shell MongoDB a besoin pour se connecter à votre instance se trouvent dans la section "cli" des chaînes de connexion. Le tableau ci-après est fourni à titre de référence.

informations sur la connexion mongo/cli
Nom de zone Index Description
Bin Le binaire recommandé pour créer une connexion ; dans ce cas, il s'agit de mongosh.
Composed Commande formatée pour établir une connexion à votre déploiement. La commande combine l'exécutable Bin, les paramètres de variable Environment et les utilisations
Environment Liste de clés/valeurs que vous définissez en tant que variables d'environnement.
Arguments 0... Informations qui sont transmises en tant qu'arguments à la commande affichée dans la zone Bin.
Certificate Base64 Certificat propriétaire de service utilisé pour confirmer qu'une application se connecte au serveur approprié. Il est encodé en base64.
Certificate Name Nom attribué au certificat propriétaire du service.
Type Type de package qui utilise ces informations de connexion ; en l'occurrence, cli.
  • 0... indique qu'il peut y avoir une ou plusieurs de ces entrées dans un tableau.

MongoDB Exemple de shell

mongosh -u admin -p $PASSWORD --tls --tlsCAFile c5f07836-d94c-11e8-a2e9-62ec2ed68f84 --authenticationDatabase admin --host replset/bd574ce4-7b36-4274-9976-96db98a3ac10-0.b8a5e798d2d04f2e860e54e5d042c915.databases.appdomain.cloud:30484,bd574ce4-7b36-4274-9976-96db98a3ac10-1.b8a5e798d2d04f2e860e54e5d042c915.databases.appdomain.cloud:30484
  • mongosh- La commande elle-même.
  • -u - Paramètre pour le nom d'utilisateur.
  • -p - Paramètre pour le mot de passe.
  • --tls --tlsCAFile- Le chemin d'accès et le nom du certificat propriétaire du service pour votre déploiement.
  • --authenticationDatabase - Base de données dans laquelle l'utilisateur et ses données d'identification sont créés et stockés.
  • --host - Nom du jeu de répliques, suivi d'un caractère /, et hôtes des membres du jeu de répliques.

Démarrage de l'interpréteur de commandes MongoDB à partir de l'interface de ligne de commande IBM Cloud

Si le MongoDB Shell est installé localement, vous pouvez utiliser la commande ibmcloud cdb deployment-connections pour gérer tout ce qui est impliqué dans la création de la connexion client. Par exemple, pour vous connecter à un déploiement nommé "example-mongo" avec un utilisateur "example-user", utilisez la commande suivante :

ibmcloud cdb deployment-connections --start -u example-user example-mongo

La commande demande le mot de passe de l'utilisateur, puis exécute le client de ligne de commande MongoDB pour se connecter à la base de données.

L'option --start doit précéder les paramètres, sinon les informations de connexion sont renvoyées et le Shell MongoDB n'est pas lancé.

Utilisation du certificat de propriété du service

  1. Copiez les informations de certificat à partir du panneau Noeuds finaux ou de la zone Base64 des informations de connexion.
  2. Si besoin, décodez la chaîne Base64 en texte.
  3. Sauvegardez le certificat dans un fichier. (Vous pouvez utiliser le nom qui est fourni ou votre propre nom de fichier.)
  4. Indiquez le chemin d'accès au certificat dans le paramètre --tlsCAFile.

Vous pouvez afficher le certificat décodé pour votre déploiement avec le plug-in d'interface de ligne de commande à l'aide de la commande suivante :

ibmcloud cdb deployment-cacert <INSTANCE_NAME_OR_CRN>

Elle décode la chaîne base64 en texte. Copiez et enregistrez la sortie de la commande dans un fichier et indiquez le chemin d'accès au fichier dans le paramètre --tlsCAFile.