MariaDB — Sauvegarde et restauration

Avant de sauvegarder

4 cmds

● Vérifier l'espace disponible sur le disque de destination
● Utiliser un compte dédié avec les privilèges strictement nécessaires
● Ne pas mettre le mot de passe directement dans la ligne de commande
● Tester régulièrement une restauration sur une base isolée
● Conserver une copie hors de la machine hébergeant MariaDB

mariadb --versionVersion du clientCopier

mariadb-dump --versionVersion de l'outil de sauvegardeCopier

mariadb -u root -p -e "SHOW DATABASES;"Vérifier la connexion et lister les basesCopier

df -h /backupVérifier l'espace disponibleCopier

Sauvegarder une base complète

2 cmds

mariadb-dump -u backup -p --databases application > application.sqlStructure et donnéesCopier

mariadb-dump -u backup -p --single-transaction --routines --events --triggers --databases application > application.sqlDump InnoDB completCopier

--single-transaction produit un instantané cohérent sans verrouiller les tables InnoDB. Il ne garantit pas la même cohérence pour les moteurs non transactionnels comme MyISAM, et les modifications de structure sont à éviter pendant l'export.

Sauvegarder plusieurs bases ou tout le serveur

2 cmds

mariadb-dump -u backup -p --single-transaction --routines --events --databases app1 app2 > applications.sqlPlusieurs basesCopier

mariadb-dump -u backup -p --single-transaction --routines --events --all-databases > toutes-les-bases.sqlToutes les basesCopier

Une sauvegarde --all-databases peut contenir des comptes et objets système sensibles. Protéger le fichier et vérifier sa compatibilité avant une restauration vers un autre serveur.

Sauvegarder des tables précises

4 cmds

mariadb-dump -u backup -p application utilisateurs commandes > tables.sqlDeux tablesCopier

mariadb-dump -u backup -p --no-data application > structure.sqlStructure uniquementCopier

mariadb-dump -u backup -p --no-create-info application > donnees.sqlDonnées uniquementCopier

mariadb-dump -u backup -p --where="created_at >= '2026-01-01'" application commandes > commandes-2026.sqlSous-ensemble de lignesCopier

Options recommandées

8 cmds

--single-transactionInstantané cohérent pour InnoDBCopier

--routinesInclure procédures et fonctionsCopier

--eventsInclure les événements planifiésCopier

--triggersInclure explicitement les triggersCopier

--hex-blobExporter les données binaires en hexadécimalCopier

--default-character-set=utf8mb4Utiliser utf8mb4Copier

--quickLire les lignes progressivementCopier

mariadb-dump -u backup -p --single-transaction --routines --events --triggers --hex-blob --default-character-set=utf8mb4 --databases application > application.sqlCopier

Compresser la sauvegarde

7 cmds

mariadb-dump -u backup -p --single-transaction --routines --events --databases application | gzip -9 > application-$(date +%F).sql.gzExport compresséCopier

mariadb-dump -u backup -p --single-transaction --databases application | zstd -T0 -10 -o application-$(date +%F).sql.zstCompression zstdCopier

Vérifier les fichiers

gzip -t application.sql.gzTester l'intégrité gzipCopier

zstd -t application.sql.zstTester l'intégrité zstdCopier

sha256sum application.sql.gz > application.sql.gz.sha256Créer une somme de contrôleCopier

sha256sum -c application.sql.gz.sha256Vérifier la somme de contrôleCopier

ls -lh application*Contrôler la taille des fichiersCopier

Inspecter un dump

3 cmds

head -n 30 application.sqlLire le début du dumpCopier

grep -n "CREATE TABLE" application.sqlLister les définitions de tablesCopier

zgrep -n "CREATE TABLE" application.sql.gzChercher dans un dump gzipCopier

La présence d'un fichier non vide ne prouve pas qu'il est restaurable. Le meilleur test reste une restauration complète dans une base temporaire.

Restaurer un dump contenant CREATE DATABASE

3 cmds

Les dumps créés avec --databases ou --all-databases contiennent les instructions de création et de sélection des bases.

mariadb -u restore -p < application.sqlRestaurer un dump non compresséCopier

gunzip -c application.sql.gz | mariadb -u restore -pRestaurer depuis gzipCopier

zstd -dc application.sql.zst | mariadb -u restore -pRestaurer depuis zstdCopier

Restaurer dans une base existante

2 cmds

mariadb -u root -p -e "CREATE DATABASE application CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"Créer la baseCopier

mariadb -u restore -p application < application.sqlImporter le dumpCopier

Si le dump contient déjà CREATE DATABASE et USE, ne pas ajouter inutilement un nom de base à la commande de restauration.

Tester une restauration isolée

5 cmds

mariadb-dump -u backup -p --single-transaction application > application-sans-create-database.sqlCopier

mariadb -u root -p -e "CREATE DATABASE restauration_test CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"Copier

mariadb -u restore -p restauration_test < application-sans-create-database.sqlCopier

mariadb -u root -p restauration_test -e "SHOW TABLES;"Copier

mariadb -u root -p restauration_test -e "SELECT COUNT(*) AS tables_presentes FROM information_schema.tables WHERE table_schema='restauration_test';"Copier

● Les tables attendues sont présentes
● Les volumes de lignes sont cohérents
● Les vues, triggers, routines et événements nécessaires existent
● L'application peut se connecter à la base restaurée
● Les caractères accentués et données binaires sont corrects

Sauvegarde et restauration avec Docker Compose

2 cmds

Créer le dump depuis le conteneur

docker compose exec -T db sh -c 'mariadb-dump -u root -p"$MARIADB_ROOT_PASSWORD" --single-transaction --routines --events --databases application' > application.sqlCopier

Restaurer dans le conteneur

docker compose exec -T db sh -c 'mariadb -u root -p"$MARIADB_ROOT_PASSWORD"' < application.sqlCopier

Le nom db correspond au service Docker Compose, pas nécessairement au nom du conteneur. Adapter le nom de la base et les variables d'environnement à la stack.

Éviter le mot de passe dans l'historique

7 cmds

Saisie interactive

mariadb-dump -u backup -p --databases application > application.sqlDemande le mot de passeCopier

Fichier d'options protégé

install -m 600 /dev/null ~/.my.cnfCréer un fichier lisible uniquement par le propriétaireCopier

[client]Copier

user=backupCopier

password=mot-de-passeCopier

host=localhostCopier

mariadb-dump --defaults-extra-file=~/.my.cnf --single-transaction --databases application > application.sqlCopier

Un fichier d'options contient un secret en clair. Limiter ses permissions à 600, protéger les sauvegardes et préférer un gestionnaire de secrets lorsqu'il est disponible.

Automatiser une sauvegarde quotidienne

9 cmds

#!/bin/bash

set -euo pipefailCopier

DEST="/backup/mariadb"Copier

DATE="$(date +%F_%H-%M-%S)"Copier

mkdir -p "$DEST"Copier

mariadb-dump --defaults-extra-file=/root/.my.cnf --single-transaction --routines --events --triggers --databases application | gzip -9 > "$DEST/application-$DATE.sql.gz"Copier

gzip -t "$DEST/application-$DATE.sql.gz"Copier

sha256sum "$DEST/application-$DATE.sql.gz" > "$DEST/application-$DATE.sql.gz.sha256"Copier

find "$DEST" -type f -name 'application-*.sql.gz*' -mtime +30 -deleteCopier

Planification cron

30 2 * * * /usr/local/sbin/backup-mariadb.sh >> /var/log/backup-mariadb.log 2>&1Chaque nuit à 02:30Copier

Diagnostic

4 cmds

echo $?Code retour de la dernière commandeCopier

tail -n 100 /var/log/backup-mariadb.logDernières lignes du journalCopier

mariadb -u root -p -e "SHOW WARNINGS;"Avertissements de la sessionCopier

mariadb -u root -p -e "SHOW PROCESSLIST;"Requêtes en coursCopier

Sauvegardes volumineuses

Pour de très grandes bases ou des restaurations rapides, une sauvegarde physique avec mariadb-backup peut être plus adaptée. mariadb-dump reste simple et portable, mais produit des fichiers plus volumineux et des restaurations plus longues.

Bonnes pratiques

● Appliquer la règle 3-2-1 : trois copies, deux supports, une copie hors site
● Chiffrer les sauvegardes contenant des données sensibles
● Surveiller la taille, la date et le code retour de chaque sauvegarde
● Inclure routines et événements lorsqu'ils sont utilisés
● Ne pas faire confiance à un dump jamais restauré
● Documenter l'ordre exact de restauration de l'application
● Tester périodiquement le plan de reprise complet