Accueil › SQL & bases de données › Faire évoluer un schéma existant
Faire évoluer un schéma existant
Créer un schémadebutant
Un schéma vit : colonnes ajoutées, types corrigés, contraintes renforcées. En développement, ALTER TABLE est anodin. En production, la question n'est pas « est-ce possible ? » mais « combien de temps la table sera-t-elle verrouillée ? ».
ALTER TABLE produit ADD COLUMN description text; -- instantané
ALTER TABLE produit ADD COLUMN actif boolean NOT NULL DEFAULT true; -- instantané (PG 11+)
ALTER TABLE produit ALTER COLUMN prix TYPE numeric(12, 2); -- réécriture complète
ALTER TABLE produit DROP COLUMN ancienne_ref; -- instantané (logique)
Deux notions suffisent à anticiper :
Le verrou. La plupart des ALTER TABLE prennent un verrou ACCESS EXCLUSIVE, qui bloque tout — y compris les lectures. S'il est pris une milliseconde, personne ne le remarque. Le danger vient de l'attente : un ALTER qui patiente derrière une requête longue met toutes les requêtes suivantes en file derrière lui.
SET lock_timeout = '3s'; -- échouer vite plutôt que bloquer la production
ALTER TABLE produit ADD COLUMN note text;
La réécriture. Changer un type de façon incompatible recopie toute la table. Sur 100 millions de lignes, c'est plusieurs minutes de verrou — inacceptable en journée.
Pour les changements qui cassent le code (renommage, suppression), la méthode est expand/contract : ajouter le nouveau, faire cohabiter, puis supprimer l'ancien.
Les termes à connaître
- ALTER TABLE
Modifie une table existante : ajouter ou supprimer une colonne, changer un type, poser ou retirer une contrainte. Certaines variantes sont instantanées, d'autres réécrivent toute la table.
- Verrou ACCESS EXCLUSIVE
Le verrou le plus fort : il bloque toutes les autres opérations sur la table, lectures comprises. La plupart des
ALTER TABLEle prennent, brièvement ou non.- Réécriture de table (*table rewrite*)
Certaines modifications recopient toute la table sur disque : changement de type incompatible, ajout d'une colonne générée. La durée est proportionnelle au volume, sous verrou.
- ADD COLUMN … DEFAULT
Depuis PostgreSQL 11, ajouter une colonne avec valeur par défaut est instantané : la valeur est stockée dans le catalogue, pas écrite dans chaque ligne. Avant, c'était une réécriture complète.
- lock_timeout
Paramètre limitant l'attente d'un verrou :
SET lock_timeout = '3s'. Sans lui, unALTER TABLEbloqué derrière une requête longue fait à son tour attendre toutes les requêtes suivantes.- Migration expand/contract
Méthode en trois temps pour changer un schéma sans coupure : étendre (ajouter le nouveau, compatible), migrer (l'application écrit et lit les deux), contracter (supprimer l'ancien).
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.