MongoDB World is back in NYC June 7 - 9!

Une introduction aux chaînes de connexion MongoDB

Après avoir installé MongoDB pour la première fois ou créé un nouveau cluster sur MongoDB Atlas, l’une des premières difficultés consiste à savoir comment vous connecter à votre base de données afin de pouvoir commencer à saisir et interroger des données. Pour vous connecter à votre cluster MongoDB, vous aurez besoin d’une chaîne de connexion.

Qu’est-ce qu’une chaîne de connexion MongoDB ?

Une chaîne de connexion MongoDB est un court texte qui indique à un client MongoDB comment se connecter à votre cluster MongoDB. L’URL peut être fournie à divers outils, tels que MongoDB Compass et le MongoDB Shell, ou elle peut figurer dans votre propre logiciel construit sur l’un des pilotes MongoDB pour spécifier un cluster MongoDB.

L’URL peut contenir diverses informations, telles que les serveurs qui composent le cluster (ou comment obtenir ces informations), votre nom d’utilisateur et mot de passe de base de données, ainsi que le nom d’une base de données par défaut à utiliser pour exécuter des requêtes, sauf si ces indications sont fournies d’une autre manière.

Comment trouver ma chaîne de connexion MongoDB ?

Vous allez rencontrer trois types de chaînes de connexion MongoDB : une chaîne de connexion MongoDB Atlas, une chaîne de connexion pour une instance exécutée sur votre propre ordinateur (localhost) et la chaîne de connexion pour un cluster auto-hébergé.

Nous allons expliquer ci-dessous comment obtenir chacune de ces chaînes de connexion.

 Comment obtenir votre chaîne de connexion MongoDB Atlas

Dans l’interface Web MongoDB Atlas, recherchez le cluster auquel vous souhaitez vous connecter, puis cliquez sur le bouton « Connexion » à côté de son nom. Dans l’écran suivant, sélectionnez la méthode que vous utilisez pour vous connecter à MongoDB. Une chaîne de connexion appropriée pour votre cluster vous est alors proposée. Servez-vous du petit bouton « copier-coller » à côté de la chaîne de connexion pour vous faciliter la tâche !

Des informations sur les chaînes de connexion MongoDB Atlas sont à votre disposition dans la documentation MongoDB.

Capture d’écran de l’interface Web d’Atlas montrant les différentes manières de se connecter à votre cluster MongoDB.

Sachez que si vous choisissez l’option MongoDB Shell, vous disposerez de l’intégralité de la ligne de commande pour lancer mongosh, en plus de la chaîne de connexion.

La chaîne de connexion ne sera pas complète. Des espaces réservés pour le nom d’utilisateur et le mot de passe sont généralement présents, entourés de chevrons, comme ceci :

mongodb+srv://<username>:<password>@beyondthebasics.abcde.mongodb.net/test

Vous devrez rechercher le nom d’utilisateur et le mot de passe de votre utilisateur de base de données, ou créer un nouvel utilisateur de base de données pour obtenir ces identifiants. Pour ce faire, utilisez le lien « Database Access » (Accès à la base de données) sur le côté gauche du site Atlas, puis cliquez sur le bouton « Add New Database User » (Ajouter un utilisateur de base de données).

 Chaîne de connexion à un serveur MongoDB local

La chaîne de connexion MongoDB pour un serveur local se présente généralement sous la forme mongodb://localhost:27017/<database>, où <database> est le nom de la base de données à laquelle vous souhaitez vous connecter. Si vous utilisez un port différent pour MongoDB, remplacez 27017 par le numéro de port que vous utilisez.

 Chaînes de connexion pour un cluster MongoDB auto-hébergé

Pour obtenir la chaîne de connexion pour un replica set MongoDB auto-hébergé, vous devrez connaître les noms d’hôte ou les adresses IP des serveurs du replica set, ainsi que le nom du replica set.

Pour spécifier les serveurs individuels dans le replica set, insérez-les dans la chaîne de connexion, comme ceci :

mongodb://<host1>:<port1>,<host2>:<port2>,<host3>:<port3>/<database>?replicaSet=<replicaSetName>

Si nous avions un replica set appelé repl1, composé de trois hôtes, 192.168.10.1-3, et que nous les exécutions tous sur le port par défaut, 27017, notre chaîne de connexion ressemblerait à ceci :

mongodb://192.168.1.1:27017,192.168.1.2:27017,192.168.1.3:27017/<database>?replicaSet=repl1

Qu’est-ce qu’une chaîne de connexion SRV MongoDB ?

Une chaîne de connexion SRV est un type de connexion qui commence par le préfixe mongodb+srv:// (au lieu de simplement mongodb://). Toutes les chaînes de connexion MongoDB Atlas sont des chaînes SRV, ce qui les rend plus courtes et plus faciles à utiliser. Le protocole SRV permet la découverte automatique des serveurs dans un replica set MongoDB ou un cluster partitionné, sans avoir besoin de spécifier les adresses individuelles des serveurs.

Les détails techniques du fonctionnement exact des chaînes de connexion SRV ne sont pas abordés ici. Nous vous invitons à consulter cet article de blog ici pour vous aider dans vos connexions de replica set et tout savoir sur ce thème.

FAQ

Comment me connecter à MongoDB à l’aide d’un identifiant de ressource uniforme (URI) ?

Pour vous connecter à MongoDB à l’aide d’un identifiant de ressource uniforme (URI), vous devez fournir une chaîne de connexion qui inclut le nom de l’hôte, le port, le nom de la base de données et les informations d’authentification.

Comment configurer une connexion MongoDB ?

Pour configurer une connexion MongoDB, vous devez installer le pilote MongoDB pour votre langage de programmation, créer une chaîne de connexion avec les paramètres appropriés et utiliser la méthode de connexion du pilote pour établir une connexion au serveur MongoDB.

Comment me connecter et interroger MongoDB ?

Pour vous connecter à MongoDB, récupérez le nom d’hôte et les informations de port à partir de Cloud Manager et utilisez un client MongoDB, tel que mongosh ou un pilote MongoDB, puis utilisez la méthode db.collection.find() dans le shell MongoDB pour interroger les documents d’une collection.