// PostgreSQL-Fehlerreferenz

PostgreSQL 40001: Zugriff konnte nicht serialisiert werden

Unter REPEATABLE READ oder SERIALIZABLE hat eine gleichzeitige Transaktion Daten geändert, von denen diese abhängt. PostgreSQL hat sie zurückgesetzt; wiederhole die gesamte Transaktion.

SQLSTATE
40001
Name
serialization_failure
Kategorie
Transaktions-Rollback
Fehlermeldung
could not serialize access due to concurrent update

Was es bedeutet

Die höheren Isolationsebenen von PostgreSQL versprechen, dass eine Transaktion einen konsistenten Snapshot sieht. Wenn es unmöglich ist, dieses Versprechen einzuhalten, weil eine andere Transaktion eine widersprüchliche Änderung bestätigt hat, bricht PostgreSQL eine von ihnen mit 40001 ab, anstatt ein Ergebnis zurückzugeben, das in serieller Reihenfolge nicht passieren könnte.

Die Meldungen variieren je nach Ursache: could not serialize access due to concurrent update oder concurrent delete (eine Zeile, die du ändern wolltest, wurde nach deinem Snapshot von jemand anderem geändert), und could not serialize access due to read/write dependencies among transactions (SERIALIZABLE hat ein gefährliches Muster erkannt). Die Abhilfe ist dieselbe: Führe die Transaktion von Anfang an erneut aus.

Häufige Ursachen

  • Zwei REPEATABLE READ oder SERIALIZABLE Transaktionen aktualisieren dieselbe Zeile; wer als Zweiter committet, scheitert.
  • A SERIALIZABLE Transaktion las Zeilen, die eine andere Transaktion dann geändert hat, in einem Muster, das eine Anomalie erzeugen könnte.
  • Stark umkämpfte Zeilen, etwa ein Zähler oder ein Kontostand, die von vielen gleichzeitigen Serializable-Transaktionen aktualisiert werden.

Wie du es behebst

  1. Erneut versuchen. Code, der REPEATABLE READ oder SERIALIZABLE muss SQLSTATE abfangen 40001 und die gesamte Transaktion, einschließlich ihrer Lesevorgänge, ein paar Mal mit kurzem Backoff neu ausführen.

  2. Halte serialisierbare Transaktionen kurz und fasse so wenige Zeilen wie möglich an.

  3. Wenn du für diese Arbeit keine Serialisierbarkeit brauchst, liest die Standardstufe READ COMMITTED stufe liest bei einem Update die neueste Zeilenversion erneut ein, anstatt fehlzuschlagen.

    BEGIN ISOLATION LEVEL READ COMMITTED;
    UPDATE counters SET n = n + 1 WHERE name = 'visits';
    COMMIT;
  4. Unter SERIALIZABLE, deklariere schreibgeschützte Transaktionen als solche; SERIALIZABLE READ ONLY DEFERRABLE verursacht niemals einen Serialisierungsfehler.

    BEGIN ISOLATION LEVEL SERIALIZABLE READ ONLY DEFERRABLE;

Sicher reproduzieren

Führe es in zwei separaten Verbindungen auf einer Testdatenbank aus.

-- 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;

Zugehörige Fehler

Der Code und der Meldungstext stammen aus der PostgreSQL-Dokumentation, Anhang A: PostgreSQL-Fehlercodes. Durchstöbere die vollständige PostgreSQL-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit PostgreSQL in SQLly

Ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense, Guardrails für riskante Anweisungen und klaren Fehlermeldungen, für PostgreSQL und die anderen Datenbanken, mit denen du arbeitest.