Frappe Framework
bench trim-tables
La commande nettoie les colonnes laissées en base quand un champ a été retiré d’un DocType. Elle sauvegarde toute la base avant de modifier le schéma.
À quoi sert la commande
Un champ retiré d’un DocType peut rester dans la table. C’est voulu, pour éviter une perte de données trop rapide. Ces colonnes finissent par peser. Les bénéfices cités d’un nettoyage régulier :
- sauvegardes plus petites ;
- sauvegardes plus rapides ;
- moindre usage de la base du site ;
- requêtes
SELECT *plus légères ; - base sans données cachées ou redondantes.
La commande modifie le schéma des tables. Par défaut, elle prend une sauvegarde complète de toute la base avant de les modifier. En cas d’erreur, bench restore ramène le site à son état d’origine.
Usage
bench trim-tables [OPTIONS]| Option | Effet |
|---|---|
--format, -f | JSON ou TEXT. Par défaut, TEXT. |
--dry-run | Montre ce qui serait supprimé |
--no-backup | Ne sauvegarde pas le site. Déconseillé : l’opération est destructrice. |
Exemple
Si une personnalisation bute sur la taille maximale d’une ligne, un essai à blanc montre les colonnes fantômes ou les anciens champs masqués :
bench --site {site} trim-tables --dry-runPoint d’attention
--no-backup retire la sauvegarde complète prise par défaut. La source distingue ce nettoyage de colonnes de bench trim-database, qui vise des tables entières.