MongoDB Compass : installation et premiers pas

MongoDB Compass vous facilite l’utilisation de MongoDB grâce à une interface utilisateur graphique. Nous vous montrons ici comment installer et utiliser cet outil.

MongoDB Compass : gérer ses bases de données plus facilement

MongoDB est l’une des solutions NoSQL les plus populaires et les plus réussies. Ce système de gestion de base de données se concentre sur le stockage et la gestion de vastes ensembles de données qui peuvent être traités dans différents formats et regroupés dans des collections sous forme de documents BSON. Bien que la solution s’efforce d’être aussi intuitive que possible, le travail avec les lignes de commande nécessite un peu de connaissances préalables et une grande précision.

Avec MongoDB Compass, vous disposez d’une interface utilisateur graphique claire qui vous permet de consulter, de modifier et d’analyser vos données. Nous vous expliquons ici comment installer MongoDB Compass sur votre système et quelles sont les possibilités que cet outil vous offre au quotidien.

Les fonctions de MongoDB Compass

MongoDB Compass peut faire tout ce que le shell rend possible. Grâce à son interface user-friendly, de nombreuses tâches seront beaucoup plus simples et rapides à réaliser. L’accès s’étend aux documents individuels, aux collections et à la construction d’une base de données complète. Parmi les tâches que vous pouvez effectuer avec MongoDB Compass, on peut citer :

• la création de nouvelles bases de données, de collections et de documents
• la représentation des données que vous avez déposées dans votre base de données
• l’ajout, la modification et la suppression d’un document
• une analyse approfondie et complète de votre système et des bases de données créées
• le contrôle permanent des performances de votre système
• un suivi et une adaptation des données selon les principes du format JSON.

À noter : MongoDB Compass est gratuit.

Conditions préalables à l’installation

Avant de pouvoir installer MongoDB Compass, vous devez d’abord choisir une version de l’outil :

• MongoDB Compass est la version complète.
• MongoDB Compass Read-Only n’offre aucune possibilité de modification ou de suppression des documents.
• MongoDB Compass Isolated fonctionne indépendamment du réseau.

Les trois versions sont disponibles au téléchargement sur le site Web MongoDB.

MongoDB Compass est compatible avec les systèmes d’exploitation les plus courants. Vous pouvez obtenir l’interface utilisateur graphique (GUI) entre autres pour OS X, Ubuntu et Windows.

Pour pouvoir utiliser l’outil, la base de données orientée documents MongoDB doit déjà être installée. Pour savoir comment faire, consultez notre tutoriel MongoDB très complet. Vous devez également disposer de droits d’administration. Bien que les étapes d’installation puissent varier légèrement en fonction du système, le travail réel avec MongoDB Compass est identique sur toutes les machines.

Comment installer MongoDB Compass ?

Si vous utilisez OS X ou Windows, il vous suffit de naviguer sur le site Web lié ci-dessus, de sélectionner la version appropriée, de la télécharger et de suivre les instructions de l’assistant d’installation. Si vous souhaitez installer MongoDB Compass sous Ubuntu, par exemple, vous avez besoin des droits sudo. Si vous les avez, vous pouvez procéder comme suit :

1. Allez sur le site Web de MongoDB Compass et copiez le lien de téléchargement pour la version appropriée.
2. Utilisez la commande wget. Pour la version 1.39.4, elle ressemble à ceci :

wget https://downloads.mongodb.com/compass/mongodb-compass_1.39.4_amd64.deb

3. Utilisez la commande apt pour installer MongoDB Compass. Voici comment l’utiliser :

sudo apt install ./mongodb-compass_1.39.4_amd64.deb

4. Une fois l’installation terminée avec succès, ouvrez MongoDB Compass :

$ mongodb-compass

Vous verrez tout d’abord un écran de démarrage. Nous vous expliquons dans les paragraphes suivants comment procéder à partir de là et quelles sont les possibilités qui s’offrent à vous.

Établir une connexion avec le serveur

Pour pouvoir utiliser MongoDB Compass, vous devez d’abord établir une connexion avec votre serveur. Le plus simple est de procéder comme suit :

1. Cliquez d’abord sur « New Connection » en haut à gauche pour établir une connexion.
2. En haut de l’écran, vous trouverez l’option « Fill in connection fields individually ». Cliquez dessus.
3. Indiquez maintenant l’IP de votre serveur distant dans le champ « Hostname ».
4. Si vous n’avez pas modifié manuellement le port au préalable, vous pouvez travailler avec la valeur par défaut « 27017 ».
5. Si vous souhaitez utiliser des mesures de sécurité supplémentaires, sélectionnez « Username / Password » sous « Authentication » et enregistrez les données de connexion que vous utilisez habituellement pour MongoDB.
6. Une fois les étapes précédentes terminées, MongoDB Compass se connecte à votre serveur. Vous obtenez alors à droite un aperçu de vos bases de données.

Créer une base de données avec MongoDB Compass

Si vous n’avez pas encore créé de base de données ou si vous souhaitez en créer une supplémentaire, rien de plus simple. Pour cela, il faut suivre les étapes suivantes :

1. Cliquez d’abord sur le bouton « CREATE DATABASE » en haut. Cela ouvre une fenêtre pop-up.
2. Donnez un nom à votre nouvelle base de données.
3. Donnez également un titre à votre collection.
4. Cliquez sur « CREATE DATABASE » en bas à droite.

Ajouter ou créer des documents

Vous pouvez également enregistrer vos données avec MongoDB Compass dans des documents BSON. Vous avez également la possibilité de créer et d’insérer de nouveaux documents dans l’interface utilisateur. Pour cela, il vous suffit de suivre les étapes suivantes :

1. Cliquez sur la base de données appropriée sur le côté gauche.
2. Sélectionnez ensuite la bonne collection. Une nouvelle fenêtre s’ouvre alors.
3. Sous « Add Data », vous avez la possibilité soit d’importer un document existant (« Import File »), soit de créer un nouveau document (« Insert Document »).

• Si vous souhaitez ajouter un document existant, cliquez sur « Import File », sélectionnez le fichier et indiquez de quel format il s’agit. Cliquez ensuite sur « IMPORT ».
• Pour créer un nouveau document, cliquez sur « Insert Document ». Une nouvelle fenêtre s’ouvre également, sur laquelle vous pouvez ajouter au choix des valeurs au format JSON ou des paires clé/valeur. Une fois le document édité, cliquez sur « INSERT ».

MongoDB Compass : consulter, modifier ou supprimer des documents

Dans MongoDB Compass, vous pouvez également consulter, modifier ou supprimer des documents. Nous vous expliquons ici brièvement ces différentes opérations.

Consulter des documents

Si vous souhaitez consulter le contenu d’un document particulier, MongoDB Compass vous propose trois vues différentes :

• sous forme de liste
• dans l’aperçu JSON
• sous forme de tableau

Il suffit de sélectionner le mode approprié dans la barre supérieure. Vous le trouverez à côté de l’option « VIEW ».

Modifier des documents

Si vous souhaitez modifier un document, procédez comme suit :

1. Affichez le document correspondant.
2. Cliquez en haut à droite sur le symbole avec le crayon.
3. Sélectionnez le champ que vous souhaitez modifier.
4. Lorsque vous avez terminé, confirmez en cliquant sur « UPDATE ».

Supprimer des documents

Il est très facile de supprimer un document dans MongoDB Compass :

1. Affichez le document concerné.
2. Assurez-vous que vous n’avez plus besoin du document.
3. Cliquez sur l’icône de la corbeille en haut à droite et confirmez l’opération.