Node.js - Intégration MongoDB : Tutoriel Complet pour Débutants

Pourquoi MongoDB est-il parfait pour Node.js ?

• Interopérabilité native : MongoDB utilise BSON (Binary JSON), un format proche de JSON, ce qui facilite l'intégration avec Node.js, un environnement JavaScript.
• Évolutivité horizontale : MongoDB est conçu pour gérer des charges importantes en se répartissant sur plusieurs serveurs, ce qui convient parfaitement aux applications modernes.
• Flexibilité des schémas : Pas besoin de définir un schéma rigide avant de commencer à stocker des données, permettant une grande adaptabilité.
• Communauté active : Avec une large communauté de développeurs, il est facile de trouver des ressources, des plugins et des solutions pour vos projets.

Comparaison entre MongoDB et MySQL

Choisir entre MongoDB et MySQL peut sembler difficile, surtout si vous débutez dans le développement backend. Voici un tableau récapitulatif des principales différences entre ces deux systèmes de gestion de bases de données populaires :

Conclusion : Le choix entre MongoDB et MySQL dépend principalement de vos besoins spécifiques. Si vous travaillez avec des données non structurées ou dynamiques et recherchez une évolutivité horizontale, MongoDB est idéal. En revanche, si vous avez besoin d'une base de données relationnelle robuste avec un support ACID complet, MySQL reste une solution solide.

Qu'est-ce que le support ACID ?

Le terme ACID fait référence à un ensemble de propriétés garantissant l'intégrité et la fiabilité des transactions dans une base de données. Ces propriétés sont essentielles pour les applications nécessitant une gestion stricte des données.

Les 4 propriétés ACID :

Atomicité (Atomicity)

Une transaction est considérée comme une unité indivisible. Toutes les opérations doivent être exécutées en totalité ou pas du tout.

Cohérence (Consistency)

Les transactions ne doivent jamais violer les règles de cohérence définies dans la base de données.

Isolation (Isolation)

Les transactions s'exécutent de manière isolée, même lorsqu'elles se produisent simultanément.

Durabilité (Durability)

Une fois qu'une transaction est validée, ses modifications sont définitivement enregistrées, même en cas de panne.

Importance : Le support ACID est crucial pour les applications nécessitant une haute fiabilité, comme les systèmes financiers ou les systèmes de réservation.

MongoDB vs MySQL : Bien que MySQL garantisse nativement le support ACID, MongoDB introduit ce support pour les transactions multi-documents depuis sa version 4.0.

Installation de MongoDB

MongoDB propose deux éditions : Community Edition (gratuite) et Enterprise Edition (payante). L'édition Community est suffisante pour la plupart des besoins en développement et en test.

Installation sous Windows

1. Télécharger l’installateur
   Rendez-vous sur le site officiel de MongoDB et téléchargez la dernière version du serveur MongoDB Community :
   • URL : https://www.mongodb.com/try/download/community
   • Lien de téléchargement direct : https://fastdl.mongodb.org/windows/mongodb-windows-x86_64-7.0.4-signed.msi
2. Exécuter l’installateur
   Double-cliquez sur le fichier .msi téléchargé pour lancer l’assistant d’installation.
3. Choisir les options d’installation
   Sélectionnez l’option Custom Installation pour choisir un dossier d’installation. Décochez l’option "Install MongoD as service" si vous souhaitez démarrer le serveur MongoDB manuellement.
4. Finaliser l’installation
   Suivez les étapes restantes de l’assistant pour terminer l’installation.
5. Créer un répertoire de données
   MongoDB nécessite un répertoire pour stocker ses données. Par défaut, il s'agit de C:\data\db. Vous pouvez aussi créer un dossier personnalisé, par exemple D:\data\db, et le spécifier au démarrage du serveur.
6. Démarrer le serveur MongoDB
   Utilisez la commande suivante pour lancer MongoDB en précisant le chemin du répertoire de données :

   📋 Copier le code

   "D:\mongodb7\mongod.exe" --dbpath="d:\data\db"
   		

   Explication : Cette commande lance le serveur MongoDB en spécifiant le chemin du répertoire où seront stockées les données.

7. Installer MongoDB Compass
   Lors de l’installation, vous serez invité à installer MongoDB Compass, une interface graphique pour interagir avec MongoDB. Si installé, vous pouvez vous connecter au serveur avec l’URL suivante :

   📋 Copier le code

   mongodb://localhost:27017
   		

   Explication : Cette URL permet de se connecter à MongoDB via MongoDB Compass ou toute autre interface cliente compatible.

Installation sous Ubuntu

1. Mettre à jour la base des paquets
   Avant d’installer MongoDB, mettez à jour la base de données des paquets :

   📋 Copier le code

   sudo apt-get update
   		

   Explication : Cette commande met à jour la liste des paquets disponibles pour garantir que vous installez la dernière version stable de MongoDB.

2. Installer MongoDB
   Pour installer la dernière version stable de MongoDB :

   📋 Copier le code

   sudo apt-get install -y mongodb-org
   		

   Explication : Cette commande installe tous les composants nécessaires, y compris le serveur (mongod) et les outils clients.

3. Démarrer et activer le service MongoDB
   Après l’installation, démarrez le service MongoDB et configurez-le pour qu’il se lance au démarrage du système :

   📋 Copier le code

   sudo systemctl start mongod
   sudo systemctl enable mongod
   		

   Explication : Ces commandes assurent que MongoDB est activé et prêt à fonctionner dès le redémarrage du système.

4. Vérifier l’installation
   Assurez-vous que MongoDB fonctionne correctement avec la commande :

   📋 Copier le code

   sudo systemctl status mongod
   		

   Explication : Cette commande affiche l'état actuel du service MongoDB pour confirmer qu'il fonctionne correctement.

Installation du driver MongoDB pour Node.js

Pour permettre l’interaction entre votre application Node.js et MongoDB, vous devez installer le module mongodb via NPM.

1. Initialiser un projet Node.js
   Créez un nouveau dossier pour votre projet et initialisez-le avec la commande suivante :

   📋 Copier le code

   D:\nodejs\mongoproj> npm init -y
   		

   Explication : Cette commande génère un fichier package.json avec les paramètres par défaut pour votre projet Node.js.

2. Installer le module MongoDB
   Installez le package mongodb avec :

   📋 Copier le code

   D:\nodejs\mongoproj> npm install mongodb
   		

   Explication : Cette commande installe le module MongoDB nécessaire pour interagir avec la base de données depuis votre application Node.js.

Connexion à MongoDB depuis Node.js

Une fois le serveur MongoDB lancé et le driver installé, vous pouvez établir une connexion entre votre application Node.js et MongoDB.

Exemple de code

Le script ci-dessous illustre comment se connecter à MongoDB :

📋 Copier le code

// Importer la classe MongoClient depuis le module mongodb
const { MongoClient } = require('mongodb');
// Définir l'URL de connexion et le nom de la base de données
const url = 'mongodb://localhost:27017'; // URL de connexion par défaut
const dbName = 'myProject'; // Nom de la base de données
// Créer une instance de MongoClient
const client = new MongoClient(url);
// Définir une fonction asynchrone pour gérer la connexion
async function main() {
try {
  // Se connecter au serveur MongoDB
  await client.connect();
  console.log('Connexion réussie au serveur');
  // Accéder à la base de données
  const db = client.db(dbName);
  // Accéder à une collection dans la base de données
  const collection = db.collection('documents');
  // Vous pouvez maintenant exécuter des opérations sur la base de données...
  return 'Terminé.';
} catch (error) {
  console.error('Une erreur s’est produite :', error);
} finally {
  // Fermer la connexion au serveur MongoDB
  await client.close();
}
}
// Exécuter la fonction principale et afficher les résultats
main()
.then(console.log)
.catch(console.error);

Explication :

• const { MongoClient } = require('mongodb'); : Importe la classe MongoClient depuis le module mongodb.
• const url = 'mongodb://localhost:27017'; : Spécifie l'URL de connexion au serveur MongoDB.
• const dbName = 'myProject'; : Définit le nom de la base de données à utiliser.
• await client.connect(); : Établit la connexion au serveur MongoDB.
• client.db(dbName); : Accède à la base de données spécifiée.
• db.collection('documents'); : Accède à une collection spécifique dans la base de données.

Bonnes pratiques pour l’intégration MongoDB avec Node.js

• Gestion des erreurs : Toujours encapsuler vos opérations de base de données dans des blocs try-catch pour gérer les erreurs potentielles.
• Fermeture des connexions : Assurez-vous de fermer les connexions après avoir terminé vos opérations pour libérer les ressources.
• Optimisation des requêtes : Utilisez des index pour accélérer les requêtes fréquemment utilisées.
• Sécurité : Configurez MongoDB avec des authentifications pour protéger vos données sensibles.

Conclusion

Dans ce tutoriel, nous avons vu comment intégrer MongoDB à une application Node.js. Nous avons couvert l’installation de MongoDB sous Windows et Ubuntu, la configuration du driver MongoDB pour Node.js, ainsi que l’établissement d’une connexion entre les deux. Avec ces bases, vous êtes désormais prêt à développer des applications robustes et évolutives exploitant la puissance de MongoDB et Node.js. 🚀

Prochain tutoriel : Apprenez à manipuler les collections MongoDB avec Node.js !