Formations — 1 037 leçons en français

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 TABLE le 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, un ALTER TABLE bloqué 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).

Lire l'explication détaillée et faire le quiz →

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.