PostgreSQL 55P03: Sperre nicht verfügbar
Eine Sperranforderung wartete nicht, sondern gab auf: NOWAIT wurde verwendet oder lock_timeout ist abgelaufen, während eine andere Sitzung eine kollidierende Sperre hielt.
- SQLSTATE
55P03- Name
lock_not_available
Was es bedeutet
Normalerweise wartet PostgreSQL auf eine Sperre, so lange es braucht. 55P03 bedeutet, dass die Anweisung angewiesen wurde, nicht zu warten: SELECT ... FOR UPDATE NOWAIT oder LOCK TABLE ... NOWAIT sofort fehlschlagen, wenn die Sperre besetzt ist, und wenn lock_timeout gesetzt ist, schlägt jede Anweisung fehl, sobald sie so lange gewartet hat. Ein Sperr-Timeout wird canceling statement due to lock timeout mit demselben Code gemeldet.
Die andere Sitzung, die die Sperre hält, ist nicht betroffen. Innerhalb eines Transaktionsblocks bricht die fehlgeschlagene Anweisung die Transaktion ab.
Häufige Ursachen
FOR UPDATE NOWAIT,FOR SHARE NOWAIToderLOCK TABLE ... NOWAITist auf eine Zeile oder Tabelle gestoßen, die eine andere Transaktion gesperrt hat.- A
lock_timeoutabgelaufen, typischerweise bei DDL wieALTER TABLE, die eine exklusive Sperre benötigt und hinter lang laufenden Abfragen wartet. - Eine lange Transaktion oder eine Sitzung, die untätig in einer Transaktion hängt und Sperren hält.
Wie du es behebst
-
Finde die Sitzung, die die Sperre hält.
SELECT pid, usename, state, xact_start, query FROM pg_stat_activity WHERE pid IN ( SELECT unnest(pg_blocking_pids(pid)) FROM pg_stat_activity ); -
Bei Job-Warteschlangen überspringe gesperrte Zeilen, statt zu scheitern.
SELECT id FROM jobs WHERE status = 'queued' ORDER BY id LIMIT 10 FOR UPDATE SKIP LOCKED;
-
Bei Schemaänderungen verwende einen kurzen
lock_timeoutbewusst und versuche es erneut, sodass dasALTERnicht hinter einer langen Abfrage in die Warteschlange gestellt wird und alle anderen blockiert.SET lock_timeout = '3s'; ALTER TABLE orders ADD COLUMN note text;
-
Beende oder verkürze die blockierende Transaktion; wurde sie verwaist, terminiere sie.
SELECT pg_terminate_backend(12345); -- the blocking pid
Sicher reproduzieren
Führe es in zwei Verbindungen aus; beende Sitzung 1 danach mit ROLLBACK.
-- Session 1: CREATE TABLE q (id int PRIMARY KEY); INSERT INTO q VALUES (1); BEGIN; SELECT * FROM q WHERE id = 1 FOR UPDATE; -- Session 2: SELECT * FROM q WHERE id = 1 FOR UPDATE NOWAIT; -- ERROR: could not obtain lock on row in relation "q"
Zugehörige Fehler
40P01Deadlock erkannt57014Anweisung wird abgebrochen55006Objekt wird gerade verwendet1222SQL Server: Zeitlimit für Sperranforderung überschritten1205MySQL: Sperr-Wartezeit überschritten3572MySQL: Sperre konnte mit NOWAIT nicht erlangt werdenORA-00054Oracle: Ressource belegt, Anforderung mit NOWAIT angegebenSQLITE_BUSYSQLite: Datenbank ist gesperrt
Weitere Fehler, wenn ein Objekt nicht im erforderlichen Zustand ist
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.
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.