Menu

Transactions PostgreSQL : BEGIN, COMMIT, ROLLBACK

Le fonctionnement des transactions PostgreSQL : BEGIN, COMMIT et ROLLBACK, les savepoints, l'effet d'une erreur sur une transaction ouverte et les niveaux d'isolation.

Cette page contient des éditeurs exécutables. Modifiez, exécutez et voyez la sortie instantanément.

Une transaction regroupe des instructions pour qu'elles prennent toutes effet, ou aucune. Ouvrez-la avec BEGIN, rendez-la définitive avec COMMIT, ou annulez tout depuis le BEGIN avec ROLLBACK. Tant que vous n'avez pas validé, les autres sessions ne voient pas vos modifications.

Alice finit avec 70 et Bob avec 80. Si le serveur plantait entre les deux mises à jour, aucune ne survivrait : l'argent ne peut pas quitter un compte sans arriver sur l'autre.

Annuler des modifications avec ROLLBACK

ROLLBACK jette toutes les modifications faites depuis le BEGIN :

Le DELETE a supprimé les trois lignes dans la transaction, et le rollback les a ramenées : le total vaut 3. Dans psql, entourez de la même façon un UPDATE ou un DELETE manuel risqué. Lancez-le après BEGIN, vérifiez le résultat avec un SELECT, puis choisissez COMMIT ou ROLLBACK.

Sans BEGIN, PostgreSQL exécute chaque instruction dans sa propre transaction et la valide quand elle se termine (autocommit). Les drivers diffèrent : psycopg, en Python, ouvre une transaction à la première instruction et attend conn.commit().

Annuler une partie d'une transaction avec SAVEPOINT

Un savepoint marque un point à l'intérieur d'une transaction. ROLLBACK TO SAVEPOINT name annule seulement le travail fait après ce point, et la transaction continue :

Le journal contient « import users » et « import products ». L'étape des commandes a été annulée sans perdre la première insertion. RELEASE SAVEPOINT name oublie un savepoint dont vous n'avez plus besoin.

Corriger « current transaction is aborted »

Quand une instruction échoue dans une transaction, PostgreSQL marque toute la transaction comme échouée et refuse chaque instruction suivante jusqu'à ce que vous la terminiez :

BEGIN;
INSERT INTO accounts VALUES ('alice', 10);   -- duplicate key: error
UPDATE accounts SET balance = 0;
-- ERROR:  current transaction is aborted, commands ignored until end of transaction block
ROLLBACK;

La solution est ROLLBACK. Un COMMIT sur une transaction annulée n'enregistre rien ; PostgreSQL répond ROLLBACK. Pour continuer après une erreur attendue, posez un savepoint avant l'instruction risquée et revenez-y. Les drivers et les ORM qui proposent des « transactions imbriquées » fonctionnent ainsi.

Annuler aussi les modifications de tables

CREATE TABLE, ALTER TABLE, DROP TABLE et la plupart des autres commandes DDL sont transactionnelles, donc une migration qui échoue à mi-chemin ne laisse aucune trace :

to_regclass renvoie NULL : pour toutes les autres sessions, la table n'a jamais existé. Quelques commandes refusent de s'exécuter dans un bloc de transaction, parmi lesquelles VACUUM, CREATE DATABASE et CREATE INDEX CONCURRENTLY.

Choisir un niveau d'isolation

Le niveau d'isolation décide quelles validations des autres sessions une transaction voit. Réglez-le avec BEGIN ISOLATION LEVEL ....

NiveauCe que voit chaque instructionQuand l'utiliser
READ COMMITTED (par défaut)Les données validées avant le début de l'instructionLa plupart des applications
REPEATABLE READUn seul instantané, pris à la première requête de la transactionRapports et exports qui doivent être cohérents
SERIALIZABLEComme REPEATABLE READ, et PostgreSQL annule les transactions dont le résultat pourrait différer d'une exécution une par uneRègles métier qui lisent puis écrivent

READ UNCOMMITTED est accepté mais se comporte comme READ COMMITTED : PostgreSQL ne montre jamais de données non validées. En REPEATABLE READ et SERIALIZABLE, attendez-vous à des erreurs avec le SQLSTATE 40001 (« could not serialize access ») et relancez toute la transaction quand vous en recevez une.

Verrouiller une ligne que vous allez modifier

Pour empêcher une autre session de modifier une ligne entre votre lecture et votre écriture, verrouillez-la au moment de la lire avec FOR UPDATE. Les autres écritures attendent votre validation :

BEGIN;
SELECT balance FROM accounts WHERE name = 'alice' FOR UPDATE;
UPDATE accounts SET balance = balance - 30 WHERE name = 'alice';
COMMIT;

Garder les transactions courtes

Une transaction ouverte conserve ses verrous de ligne jusqu'à sa fin, et elle empêche VACUUM de supprimer les anciennes versions des lignes. Une session laissée « idle in transaction » par un script planté peut bloquer les autres écritures pendant des heures. Réglez idle_in_transaction_session_timeout pour fermer automatiquement ces sessions.

Dans une transaction, now() renvoie la même heure pour chaque instruction : l'heure de début de la transaction (voir les fonctions de dates). Le tutoriel officiel sur les transactions donne d'autres exemples.

Questions fréquentes

PostgreSQL utilise-t-il l'autocommit ?

Oui. Une instruction envoyée hors d'un BEGIN s'exécute dans sa propre transaction et est validée quand elle se termine. Certains drivers font l'inverse : psycopg, en Python, ouvre une transaction pour vous et attend commit(), sauf si vous activez l'autocommit.

Quel est le niveau d'isolation par défaut dans PostgreSQL ?

READ COMMITTED. Chaque instruction voit les données validées avant son propre début. Utilisez BEGIN ISOLATION LEVEL REPEATABLE READ ou SERIALIZABLE quand une transaction doit voir un instantané cohérent unique.

Peut-on annuler un CREATE TABLE ou un ALTER TABLE dans PostgreSQL ?

Oui. Presque tout le DDL de PostgreSQL est transactionnel, donc un CREATE, un ALTER ou un DROP dans une transaction disparaît au ROLLBACK. Quelques commandes, comme CREATE DATABASE, VACUUM et CREATE INDEX CONCURRENTLY, ne peuvent pas du tout s'exécuter dans un bloc de transaction.

Quelle différence entre COMMIT et END dans PostgreSQL ?

Aucune. END est une extension de PostgreSQL qui fait la même chose que COMMIT, et START TRANSACTION est l'écriture standard de BEGIN.

Illustration des langages de programmation de Coddy

Apprendre à coder avec Coddy

Commencer