// Référence des erreurs PostgreSQL

PostgreSQL 40001 : impossible de sérialiser l'accès

Sous REPEATABLE READ ou SERIALIZABLE, une transaction concurrente a modifié des données dont celle-ci dépendait. PostgreSQL l’a annulée ; réessayez toute la transaction.

SQLSTATE
40001
Nom
serialization_failure
Catégorie
Annulation de transaction
Message d'erreur
could not serialize access due to concurrent update

Ce que cela signifie

Les niveaux d'isolation supérieurs de PostgreSQL garantissent qu'une transaction voit un instantané cohérent. Lorsque tenir cette promesse est impossible parce qu'une autre transaction a validé une modification conflictuelle, PostgreSQL interrompt l'une des deux avec 40001 plutôt que de renvoyer un résultat qui ne pourrait pas se produire dans un ordre sérialisable.

Les messages varient selon la cause : could not serialize access due to concurrent update ou concurrent delete (une ligne que vous avez essayé de modifier a été changée par quelqu'un d'autre après votre instantané), et could not serialize access due to read/write dependencies among transactions (SERIALIZABLE a détecté un schéma d’accès dangereux). Le remède est le même : relancez la transaction depuis le début.

Causes courantes

  • Deux REPEATABLE READ ou SERIALIZABLE les transactions mettent à jour la même ligne ; la deuxième à valider échoue.
  • A SERIALIZABLE une transaction lit des lignes qu’une autre transaction a ensuite modifiées, selon un schéma pouvant produire une anomalie.
  • Lignes chaudes, comme un compteur ou un solde, mises à jour par de nombreuses transactions sérialisables simultanées.

Comment le corriger

  1. Réessayer. Le code qui utilise REPEATABLE READ ou SERIALIZABLE doit intercepter SQLSTATE 40001 et relancer toute la transaction, y compris ses lectures, plusieurs fois avec un court délai entre les tentatives.

  2. Garder les transactions sérialisables courtes et toucher le moins de lignes possible.

  3. Si vous n'avez pas besoin de sérialisabilité pour ce travail, le niveau par défaut READ COMMITTED relit la dernière version de la ligne lors de la mise à jour au lieu d'échouer.

    BEGIN ISOLATION LEVEL READ COMMITTED;
    UPDATE counters SET n = n + 1 WHERE name = 'visits';
    COMMIT;
  4. Sous SERIALIZABLE, déclarez les transactions en lecture seule comme telles ; SERIALIZABLE READ ONLY DEFERRABLE n'échoue jamais avec une erreur de sérialisation.

    BEGIN ISOLATION LEVEL SERIALIZABLE READ ONLY DEFERRABLE;

Reproduisez-le en toute sécurité

Exécutez sur deux connexions distinctes dans une base de données de test.

-- Session 1:
CREATE TABLE acct (id int PRIMARY KEY, bal int);
INSERT INTO acct VALUES (1, 100);
BEGIN ISOLATION LEVEL REPEATABLE READ;
SELECT bal FROM acct WHERE id = 1;
-- Session 2:
UPDATE acct SET bal = 50 WHERE id = 1;
-- Session 1:
UPDATE acct SET bal = bal - 10 WHERE id = 1;  -- ERROR: could not serialize access due to concurrent update
ROLLBACK;

Erreurs liées

Le code et le texte du message sont issus de Documentation PostgreSQL, annexe A : Codes d’erreur PostgreSQL. Parcourir la liste complète Liste des erreurs PostgreSQL ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur PostgreSQL dans SQLly

Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d'erreur clairs, pour PostgreSQL et les autres bases de données que vous utilisez.