Cours MariaDB / Restaurer une sauvegarde dans une base distincte et la vérifier
Pour vérifier une sauvegarde MariaDB, restaurez-la dans une autre base vide, puis comparez les définitions, les lignes, les contraintes et les totaux métier. Examinez d’abord les instructions qui changent de base ou suppriment des objets, et arrêtez le traitement en cas d’erreur afin de ne pas confondre une restauration partielle avec une réussite complète.
Examiner le fichier avant de choisir la cible
Le nom de base choisi à la connexion ne limite pas toutes les actions d’un fichier SQL. CREATE DATABASE, USE et des noms d’objets qualifiés par une autre base peuvent diriger les instructions ailleurs. Un dump peut aussi contenir DROP TABLE : une base existante avec des données à conserver n’est donc pas une cible de test appropriée.
Vérifiez la provenance de confiance du fichier, les versions et les options qui ont servi à le produire. Le cours sur la sauvegarde avec mariadb-dump explique pourquoi la taille et l’empreinte ne suffisent pas. Une empreinte SHA-256 permet de vérifier qu’une copie correspond au fichier choisi ; elle ne rend pas fiable un fichier dont la source est inconnue.
| Étape | À examiner | Décision à prendre |
|---|---|---|
| Lecture du fichier | CREATE DATABASE, USE, DROP et DEFINER | Les instructions peuvent-elles sortir de la cible ? |
| Cible vide | Serveur réel, nom et privilèges | Est-elle distincte de la source ? |
| Exécution | Première erreur et état du client | Réussite complète ou état partiel ? |
| Validation | Objets, lignes, clés et résultats métier | Les valeurs correspondent-elles à la référence ? |
La référence officielle de mariadb-dump précise le contenu et les options des sauvegardes. Une restauration exécute des instructions SQL : lisez le fichier et contrôlez les comptes définisseurs, appelés DEFINER, au lieu de traiter le dump comme un simple document inoffensif.
Préparer une source indépendante et un nouveau dump
Utilisez un serveur d’apprentissage et un compte course_user existant pour les connexions TCP locales. Avec l’administrateur, vérifiez par SHOW DATABASES; que restore47_source et restore47_target sont disponibles. Si l’un de ces noms existe, examinez-le et choisissez d’autres noms dans toutes les étapes ; ne supprimez pas une base existante pour libérer un nom.
Le bloc suivant fournit une source complète, indépendante du cours précédent. Enregistrez-le en UTF-8, par exemple dans C:/mariadb-lab/c47-preparation.sql, puis exécutez SOURCE C:/mariadb-lab/c47-preparation.sql; dans le client MariaDB de l’administrateur, avec le chemin réel.
CREATE DATABASE restore47_source CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
USE restore47_source;
CREATE TABLE c47_customers (
customer_id INT NOT NULL PRIMARY KEY,
customer_name VARCHAR(50) NOT NULL,
city VARCHAR(30) NOT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
CREATE TABLE c47_products (
product_id INT NOT NULL PRIMARY KEY,
product_name VARCHAR(100) NOT NULL,
category VARCHAR(30) NOT NULL,
price DECIMAL(10,2) NOT NULL CHECK (price >= 0),
stock INT NOT NULL CHECK (stock >= 0)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
CREATE TABLE c47_orders (
order_id INT NOT NULL PRIMARY KEY,
customer_id INT NOT NULL,
ordered_at DATETIME NOT NULL,
status VARCHAR(20) NOT NULL,
shipping_fee DECIMAL(10,2) NOT NULL DEFAULT 1000,
CONSTRAINT fk_c47_order_customer FOREIGN KEY (customer_id)
REFERENCES c47_customers(customer_id) ON DELETE RESTRICT
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
CREATE TABLE c47_items (
order_id INT NOT NULL,
product_id INT NOT NULL,
quantity INT NOT NULL CHECK (quantity > 0),
unit_price DECIMAL(10,2) NOT NULL CHECK (unit_price >= 0),
PRIMARY KEY (order_id, product_id),
CONSTRAINT fk_c47_item_order FOREIGN KEY (order_id)
REFERENCES c47_orders(order_id) ON DELETE RESTRICT,
CONSTRAINT fk_c47_item_product FOREIGN KEY (product_id)
REFERENCES c47_products(product_id) ON DELETE RESTRICT
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
INSERT INTO c47_customers VALUES
(1,'김민수','서울'),(2,'이서연','부산'),
(3,'박지우','서울'),(4,'최하늘','대전');
INSERT INTO c47_products VALUES
(1,'노트','문구',3500,20),(2,'볼펜','문구',1500,50),
(3,'머그컵','생활',8000,12),(4,'스탠드','생활',25000,5);
INSERT INTO c47_orders
(order_id,customer_id,ordered_at,status,shipping_fee) VALUES
(101,1,'2026-01-10 10:00:00','paid',1000),
(102,1,'2026-01-20 11:00:00','paid',1000),
(103,2,'2026-02-05 12:00:00','paid',1000),
(104,3,'2026-02-10 13:00:00','canceled',1000);
INSERT INTO c47_items VALUES
(101,1,2,3500),(101,2,3,1500),(102,3,1,8000),
(103,1,1,3500),(103,3,2,8000),(104,2,1,1500);
Les noms et villes coréens sont conservés pour reproduire le même jeu de données UTF-8. Les produits 1 à 4 sont un carnet, un stylo, une tasse et une lampe. Les clients 1 et 3 ont la ville Séoul ; les clients 2 et 4 ont Busan et Daejeon. Comparez les identifiants et les valeurs, sans remplacer les littéraux pendant l’exercice.
Accordez les droits limités aux bases d’apprentissage et créez la cible vide avec l’administrateur :
GRANT ALL PRIVILEGES ON restore47_source.* TO 'course_user'@'127.0.0.1';
CREATE DATABASE restore47_target CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
GRANT ALL PRIVILEGES ON restore47_target.* TO 'course_user'@'127.0.0.1';
ALL PRIVILEGES est ici limité à chacune des deux bases jetables. Un compte de restauration réel doit recevoir les droits adaptés aux objets et à la procédure ; cet exemple n’accorde pas un accès général à toutes les bases du serveur.
Dans le terminal PowerShell du système, créez un nouveau fichier de sauvegarde. Le port 3306 suppose un serveur local à ce port ; adaptez l’adresse et le port à votre serveur d’apprentissage. Le mot de passe doit être saisi à l’invite. Contrôlez le code de sortie avant de poursuivre :
New-Item -ItemType Directory -Path 'C:/mariadb-lab' -Force | Out-Null
$courseBackupPath='C:/mariadb-lab/restore47-source.sql'
if (Test-Path -LiteralPath $courseBackupPath) { throw 'Choose a new backup filename.' }
mariadb-dump --protocol=tcp --host=127.0.0.1 --port=3306 --user=course_user --password --default-character-set=utf8mb4 --single-transaction --quick --skip-lock-tables --result-file=$courseBackupPath restore47_source
if ($LASTEXITCODE -ne 0) { throw 'Backup failed; do not restore this file.' }
Get-Item -LiteralPath $courseBackupPath | Select-Object Name,Length
Get-FileHash -LiteralPath $courseBackupPath -Algorithm SHA256
Variante pour un shell Ubuntu : utilisez cette variante ou celle de PowerShell. Le sous-shell limite à cette opération les permissions restrictives de umask 077 et la protection de redirection set -C contre l’écrasement :
mkdir -p "$HOME/mariadb-lab"
(
umask 077
set -C
backup_file="$HOME/mariadb-lab/restore47-source.sql"
if mariadb-dump --protocol=tcp --host=127.0.0.1 --port=3306 \
--user=course_user --password --default-character-set=utf8mb4 \
--single-transaction --quick --skip-lock-tables restore47_source > "$backup_file"; then
test -s "$backup_file" || exit 1
sha256sum "$backup_file"
else
printf '%s\n' 'Backup failed; preserve the partial file for diagnosis.' >&2
exit 1
fi
)
Un fichier de destination existant doit provoquer l’arrêt de cette procédure. Une erreur peut laisser une sortie vide ou partielle : conservez le diagnostic et recommencez avec un nouveau nom après correction. La taille et SHA-256 sont des éléments de preuve, mais ne constituent pas le test de restauration.
Si vous utilisez plutôt le fichier du cours précédent, reprenez ses vrais noms de tables et ses résultats de référence. Ne mélangez pas les tables c46 et c47 ou leurs noms de bases. Si une erreur TLS survient, contrôlez les versions, le nom du certificat, l’autorité de confiance et les éventuels certificats clients selon les conditions officielles des connexions chiffrées. Appliquez les options appropriées aux deux clients ; ne désactivez pas habituellement la vérification du serveur.
Vérifier la cible vide et la compatibilité des clients
Après examen du dump, ouvrez le client vers la cible prévue. L’option --abort-source-on-error arrête le traitement d’un fichier SOURCE en cas d’erreur. La commande suivante se lance dans le terminal du système :
mariadb --abort-source-on-error --protocol=tcp --host=127.0.0.1 --port=3306 --user=course_user --password --default-character-set=utf8mb4 restore47_target
Dans cette connexion MariaDB, contrôlez le serveur et la base, puis assurez-vous que SHOW TABLES ne renvoie aucune table avant d’exécuter SOURCE :
SELECT VERSION(),DATABASE();
SHOW TABLES;
SOURCE C:/mariadb-lab/restore47-source.sql;
Le résultat de DATABASE() doit être restore47_target. Si des tables apparaissent avant la restauration, arrêtez-vous : vous n’avez pas une cible vide conforme à cet exercice. Un nom correctement affiché ne protège toutefois pas d’un USE ou d’un nom qualifié présent dans le fichier ; c’est la raison de la lecture préalable.
Les dumps récents peuvent commencer par une directive du mode sandbox du client MariaDB. Un ancien client MariaDB ou un client MySQL peut ne pas la comprendre. Choisissez une combinaison de versions compatible plutôt que de supprimer automatiquement une directive inconnue. L’existence du fichier et la compatibilité du client sont deux contrôles différents.
Pour restaurer depuis un client Ubuntu, ouvrez la même cible avec la commande suivante. Le chemin SOURCE doit être le chemin absolu réel du fichier du client ; learner est seulement le nom de connexion utilisé dans l’exemple :
mariadb --abort-source-on-error --protocol=tcp --host=127.0.0.1 --port=3306 --user=course_user --password --default-character-set=utf8mb4 restore47_target
SELECT DATABASE();
SHOW TABLES;
SOURCE /home/learner/mariadb-lab/restore47-source.sql;
Exécutez une seule des variantes de restauration pour une cible donnée. L’option d’arrêt empêche les instructions suivantes du fichier d’être traitées ; elle ne supprime pas les objets déjà créés et n’annule pas les changements déjà validés. En cas d’échec, notez la première erreur, corrigez sa cause et préparez une nouvelle cible vide avant de recommencer.
Comparer les objets, les lignes et les résultats métier
Après la restauration, exécutez les contrôles suivants dans le client MariaDB. Les noms sont explicitement qualifiés par la base cible pour éviter de comparer accidentellement la source avec elle-même :
SELECT TABLE_NAME,TABLE_TYPE FROM information_schema.TABLES
WHERE TABLE_SCHEMA='restore47_target' ORDER BY TABLE_NAME;
SELECT (SELECT COUNT(*) FROM restore47_target.c47_customers) AS customers,
(SELECT COUNT(*) FROM restore47_target.c47_products) AS products,
(SELECT COUNT(*) FROM restore47_target.c47_orders) AS orders_count,
(SELECT COUNT(*) FROM restore47_target.c47_items) AS detail_rows;
SELECT SUM(i.quantity*i.unit_price) AS paid_goods
FROM restore47_target.c47_orders o
JOIN restore47_target.c47_items i ON i.order_id=o.order_id WHERE o.status='paid';
SHOW CREATE TABLE restore47_target.c47_items;
Les résultats attendus sont quatre tables de type BASE TABLE, les comptes 4, 4, 4 et 6, puis un total des marchandises payées de 39000.00. La commande annulée n’entre pas dans ce total. Examinez dans SHOW CREATE TABLE la clé primaire composée, les clés étrangères et les contraintes sur la quantité et le prix.
Des nombres de lignes identiques ne prouvent pas un contenu identique. Pour chaque table, comparez les lignes par clé avec la source et contrôlez les noms UTF-8, les dates, les statuts, les quantités et les prix. Rejouez aussi les requêtes métier prévues. Une modification de prix compensée par une autre pourrait conserver un compte de lignes tout en changeant les résultats.
Dans une base réelle, vérifiez aussi les vues, routines, déclencheurs et événements nécessaires, leurs définitions et leur comportement. Un dump de base ne recrée pas automatiquement tous les comptes, privilèges et paramètres du serveur. Les comptes définisseurs et appelants doivent être examinés séparément.
Repérer un état partiellement restauré et corriger l’échec
Une erreur de syntaxe, de privilège, de compte définisseur ou de jeu de caractères peut se produire après la création de certains objets. N’ajoutez pas --force pour continuer puis annoncer une réussite. Conservez l’erreur, les versions et l’inventaire des objets partiels afin de comprendre ce qui s’est exécuté.
Ne désactivez pas arbitrairement les contrôles de clés étrangères pour masquer un problème. Examinez les réglages que le dump sauvegarde puis restaure. Les opérations de définition de données d’une restauration complète ne forment pas une seule transaction ordinaire qu’un ROLLBACK suffirait à annuler.
Pour une nouvelle tentative, choisissez un nom de cible inutilisé, créez cette base vide et donnez au compte les droits limités à cette cible. Adaptez ensuite le nom dans la connexion et dans toutes les requêtes de contrôle. Conservez la cible partielle tant que son examen est utile ; ne supprimez pas automatiquement une base dont vous n’avez pas confirmé l’usage. La bascule d’une application et la prévention de nouvelles écritures relèvent d’une procédure opérationnelle distincte.
Conserver les preuves avant le nettoyage
Consignez l’empreinte du dump, les versions du client et du serveur, la cible réellement utilisée, l’heure d’exécution et les requêtes de validation avec leurs résultats. Gardez la source et la sauvegarde jusqu’à la fin des contrôles. Cette trace permet de distinguer un fichier copié correctement d’une récupération qui a réellement été testée.
Avant de supprimer une base d’apprentissage, confirmez qu’elle a été créée exclusivement pour cet exercice et conservez ce qui doit rester. Aucune commande automatique DROP DATABASE n’est incluse ici. Une restauration vérifiée doit démontrer la cohérence des données et des objets, sans mettre en danger la base source ou un environnement existant.




