Sauvegarder et restaurer MongoDB : mongodump et mongorestore

Sauvegarder une base MongoDB, c'est en copier les données dans un fichier qu'on pourra recharger en cas de perte. L'outil standard est mongodump, qui exporte les collections au format BSON avec la définition de leurs index ; son pendant, mongorestore, les recharge dans une base. Ce chapitre montre les commandes utiles, les automatise avec un script planifié, et insiste sur l'étape que l'on oublie : tester la restauration. Les principes généraux (règle 3-2-1, RPO et RTO, rétention, plan de sauvegarde) sont dans le cours sur la sauvegarde et le PRA.

Les outils

mongodump, mongorestore, mongoexport et mongoimport font partie des MongoDB Database Tools, un paquet séparé du serveur (version 100.x, la 100.20.0 en novembre 2026). Ils sont inclus dans l'image Docker mongo et dans le paquet Linux mongodb-org ; sur Windows et macOS, on les télécharge à part (sur macOS, Homebrew les installe après brew tap mongodb/brew : brew install mongodb-database-tools). Ils se connectent avec la même chaîne de connexion que les autres clients.

Sauvegarder avec mongodump

# Toute la base appli_frais, dans un dossier daté : un fichier .bson et un .metadata.json par collection
mongodump --uri="mongodb://sauvegarde:<mdp>@localhost:27017/?authSource=admin" \
          --db=appli_frais --out=dump-2026-11-02

writing `appli_frais.fiches` to `dump-2026-11-02/appli_frais/fiches.bson`
writing `appli_frais.visiteurs` to `dump-2026-11-02/appli_frais/visiteurs.bson`
done dumping `appli_frais.fiches` (9 documents)
done dumping `appli_frais.visiteurs` (5 documents)

Le plus pratique pour un script est une archive compressée, un seul fichier :

mongodump --uri="mongodb://sauvegarde:<mdp>@localhost:27017/?authSource=admin" \
          --db=appli_frais --archive=appli_frais-2026-11-02.archive.gz --gzip

Les options les plus utiles :

Le compte utilisé est celui du chapitre 13, avec le rôle backup : il peut tout lire pour sauvegarder, mais ni modifier, ni supprimer.

Avec Docker, on lance mongodump dans le conteneur et on récupère l'archive sur la sortie standard :

docker compose exec -T mongo mongodump --archive --gzip --db=appli_frais \
  -u sauvegarde -p "$MDP_SAUVEGARDE" --authenticationDatabase admin > appli_frais-$(date +%F).archive.gz

--archive sans nom de fichier écrit sur la sortie standard, que le > redirige vers un fichier de ta machine ; -T désactive le terminal interactif, qui corromprait le flux binaire.

Restaurer avec mongorestore

# Restaurer l'archive dans une base de TEST, pour vérifier qu'elle est exploitable
mongorestore --uri="mongodb://sauvegarde:<mdp>@localhost:27017/?authSource=admin" \
             --archive=appli_frais-2026-11-02.archive.gz --gzip \
             --nsFrom='appli_frais.*' --nsTo='appli_frais_test.*' --drop

restoring `appli_frais_test.fiches` from "archive `appli_frais-2026-11-02.archive.gz`"
finished restoring `appli_frais_test.fiches` (9 documents, 0 failures)
restoring `appli_frais_test.visiteurs` from "archive `appli_frais-2026-11-02.archive.gz`"
finished restoring `appli_frais_test.visiteurs` (5 documents, 0 failures)
restoring indexes for collection `appli_frais_test.visiteurs` from metadata
restoring indexes for collection `appli_frais_test.fiches` from metadata
14 document(s) restored successfully. 0 document(s) failed to restore.

Restaurer une collection dans une base de test, puis recopier quelques documents dans la production, est la bonne méthode pour réparer une erreur limitée (une fiche supprimée par erreur) sans écraser le travail fait depuis la sauvegarde.

Exporter et importer des données

# Les fiches payées, en CSV pour le service comptable
mongoexport --uri="mongodb://appli:<mdp>@localhost:27017/appli_frais" \
            --collection=fiches --type=csv --fields=mois,etat,montantValide \
            --query='{"etat":{"$in":["VA","MP","RB"]}}' --sort='{"mois":1,"etat":1}' \
            --out=fiches-payees.csv

mois,etat,montantValide
2026-08,RB,512.2
2026-08,VA,184.4
2026-09,MP,562.4
2026-09,VA,898.9

En JSON, mongoexport écrit un document par ligne, au format Extended JSON, qui garde la trace des types : {"_id":{"$oid":"6a0000000000000000000001"}, …, "dateEmbauche":{"$date":"2021-09-01T00:00:00Z"}}. mongoimport sait relire ce format, ainsi que du CSV (--type=csv --headerline) : c'est la façon simple de charger une liste de visiteurs fournie par le service des ressources humaines.

Automatiser la sauvegarde

Une sauvegarde manuelle finit toujours par être oubliée. Sur un serveur Linux, un script planifié par cron fait le travail chaque nuit :

#!/usr/bin/env bash
# /usr/local/bin/sauvegarde-mongodb.sh : sauvegarde quotidienne de la base appli_frais
set -euo pipefail

DOSSIER=/sauvegardes/mongodb
FICHIER="$DOSSIER/appli_frais-$(date +%F).archive.gz"
mkdir -p "$DOSSIER"

# /etc/sauvegarde-mongodb.yaml (chmod 600) contient la ligne : uri: mongodb://sauvegarde:…@localhost:27017/?authSource=admin
mongodump --config=/etc/sauvegarde-mongodb.yaml --db=appli_frais --archive="$FICHIER" --gzip

# Vérifier que l'archive n'est pas vide, puis garder 14 jours de sauvegardes locales
test -s "$FICHIER"
find "$DOSSIER" -name 'appli_frais-*.archive.gz' -mtime +14 -delete

# crontab -e (compte dédié aux sauvegardes) : tous les jours à 2 h 30
30 2 * * * /usr/local/bin/sauvegarde-mongodb.sh >> /var/log/sauvegarde-mongodb.log 2>&1

set -euo pipefail arrête le script à la première erreur, au lieu de supprimer d'anciennes sauvegardes après un mongodump raté. Les fondamentaux du scripting Bash et de la planification sont dans le cours de scripting. Sur Windows Server, le Planificateur de tâches lance un script PowerShell équivalent.

Ce script ne fait que la première copie. La règle 3-2-1 en demande trois, sur deux supports différents, dont une hors site : copie l'archive vers un NAS ou un stockage objet (avec rclone ou restic), et garde au moins une copie hors ligne ou immuable, qu'un rançongiciel ne pourra pas chiffrer. Les sauvegardes contiennent des données personnelles : chiffre-les avant de les envoyer hors du site (restic chiffre nativement ; sinon gpg ou age).

Atlas et les autres méthodes

• Atlas sauvegarde lui-même les clusters : sur l'offre gratuite, si tu actives la sauvegarde, un instantané par jour, quatre gardés ; sur les offres payantes, des instantanés continus qui permettent de revenir à n'importe quelle minute. mongodump fonctionne aussi sur Atlas (sans --oplog ni la base admin sur l'offre gratuite) : garder ta propre copie hors d'Atlas reste une bonne pratique, pour ne pas dépendre d'un seul fournisseur.
• L'instantané du système de fichiers (LVM, ZFS, instantané de la VM) copie les fichiers de données en quelques secondes, quelle que soit la taille de la base. Il doit être pris de façon cohérente (journalisation activée, ou base verrouillée avec db.fsyncLock() le temps de l'instantané).
• Un membre de replica set n'est pas une sauvegarde : une suppression par erreur est répliquée sur tous les membres en quelques millisecondes (réplication et sauvegarde).

Tester la restauration

// Après la restauration de test, dans mongosh
const t = db.getSiblingDB('appli_frais_test');
t.fiches.countDocuments();                       // 9, comme la production au moment de la sauvegarde
t.visiteurs.countDocuments();                    // 5
t.fiches.getIndexes().map(i => i.name);          // [ '_id_', 'visiteur_1_mois_1', 'etat_1_mois_-1' ]
t.dropDatabase();                                // nettoyer après le test

Exercices

# 1.
mongodump --uri="$URI_SAUVEGARDE" --db=appli_frais --archive="appli_frais-$(date +%F).archive.gz" --gzip

# 2. Le filtre en Extended JSON ; mois est une chaîne AAAA-MM, un intervalle suffit
mongodump --uri="$URI_SAUVEGARDE" --db=appli_frais --collection=fiches \
          --query='{"mois":{"$gte":"2026-01","$lte":"2026-12"}}' --archive=fiches-2026.archive.gz --gzip

# 3.
mongorestore --uri="$URI_SAUVEGARDE" --archive=appli_frais-2026-11-02.archive.gz --gzip \
             --nsInclude='appli_frais.visiteurs' --nsFrom='appli_frais.*' --nsTo='appli_frais_test.*' --drop

# 4.
mongoexport --uri="$URI_LECTURE" --db=appli_frais --collection=visiteurs \
            --type=csv --fields=matricule,nom,prenom,region --out=visiteurs.csv