Documentation Frappe Framework

Frappe Framework

bench transform-database

La commande change le moteur ou le format de ligne de tables MariaDB. Elle sert surtout à quitter ROW_FORMAT COMPRESSED.

1 min de lectureMis à jour le Source : docs.frappe.io

Portée

À retenir

La commande est ajoutée en version 14 et ne prend en charge que MariaDB.

bench transform-database règle les tables du site. À ce stade, on peut changer le moteur de stockage et le ROW_FORMAT des tables choisies.

MariaDB 10.6 a déprécié ROW_FORMAT COMPRESSED, qui a longtemps été le choix par défaut de Frappe. La commande a été ajoutée pour les montées vers des MariaDB plus récentes. La source renvoie à la pull request frappe/frappe numéro 13954.

Usage

terminal
bench transform-database [OPTIONS] table
OptionRôle
--tableNoms de tables séparés par des virgules, ou all. Obligatoire.
--engineInnoDB ou MyISAM
--row_formatDYNAMIC, COMPACT, REDUNDANT ou COMPRESSED
failfastQuitte à la première erreur. La source le liste parmi les drapeaux, sans tiret.

Exemples

Passer la table tabAccess Record en MyISAM, par exemple une table de journal très écrite et peu lue :

terminal
bench --site {site} transform-database --table 'tabAccess Record' --engine 'MyISAM'

Après un passage de MariaDB 10.3 à 10.7, convertir toutes les tables COMPRESSED vers DYNAMIC :

terminal
bench --site {site} transform-database --table 'all' --row_format 'DYNAMIC'

Point d’attention

--table est obligatoire. La commande ne concerne pas PostgreSQL. COMPRESSED reste dans la liste des formats, alors que la note explique justement qu’il est déprécié côté MariaDB 10.6.

bench transform-database MariaDB Frappe | ERPNext Lab