Frappe Framework
bench restore
La commande recharge la base depuis un fichier sql ou sql.gz. Les archives de fichiers sont en tar, ou en tgz depuis la version 13.
À quoi sert la commande
bench restore ramène un site à un état précédent, base et fichiers. Les descentes de version ne sont pas prises en charge : si une descente est détectée, une confirmation s’affiche avant de commencer.
Le minimum est le fichier de base sur le disque local. Le chemin peut être relatif à la racine du bench ou au dossier des sites. Un chemin absolu est souvent le plus sûr. L’extension est sql.gz ou sql. Les archives de fichiers publics et privés sont en tar par défaut. Depuis la version 13, les archives compressées tgz sont aussi acceptées.
À retenir
On ne peut pas restaurer seulement les fichiers avec cette commande.
Le chiffrement éventuel est décrit dans Activer le chiffrement des sauvegardes. Une restauration de tables seules passe par bench partial-restore.
Usage
bench restore [OPTIONS] SQL_FILE_PATH| Option | Rôle |
|---|---|
--db-root-username, --db-root-password | Compte racine MariaDB ou Postgres |
--db-name | Nom de base si le site est nouveau |
--admin-password | Mot de passe administrateur du nouveau site |
--install-app | Application à installer après la restauration |
--with-public-files, --with-private-files | Chemins des archives de fichiers |
--force | Ignore l’avertissement de descente de version. Déconseillé sans en mesurer les conséquences. |
Exemples
Restauration avec fichiers, avec identifiants racine, avec une application, un nom de base ou un mot de passe administrateur : chaque option s’ajoute à bench --site {site} restore {path/to/database/file}.
Point d’attention
Sans fichier SQL, la restauration ne démarre pas. --force passe l’avertissement de descente de version. Les fichiers seuls ne se restaurent pas : la base reste obligatoire.