// Référence des erreurs PostgreSQL

PostgreSQL 55P03 : verrou non disponible

Une requête de verrouillage a renoncé au lieu d'attendre : NOWAIT a été utilisé, ou lock_timeout a expiré tandis qu'une autre session détenait un verrou en conflit.

SQLSTATE
55P03
Nom
lock_not_available
Catégorie
L'objet n'est pas dans l'état requis
Message d'erreur
could not obtain lock on row in relation "orders"

Ce que cela signifie

Normalement, PostgreSQL attend un verrou aussi longtemps que nécessaire. 55P03 signifie que l'instruction a reçu pour consigne de ne pas attendre : SELECT ... FOR UPDATE NOWAIT ou LOCK TABLE ... NOWAIT échouer immédiatement si le verrou est pris, et lorsque lock_timeout est défini, toute instruction échoue une fois qu'elle a attendu aussi longtemps. Un dépassement du délai de verrou signale canceling statement due to lock timeout avec le même code.

L’autre session qui détient le verrou n’est pas affectée. Dans un bloc de transaction, l’instruction qui a échoué annule la transaction.

Causes courantes

  • FOR UPDATE NOWAIT, FOR SHARE NOWAIT ou LOCK TABLE ... NOWAIT tombent sur une ligne ou une table qu'une autre transaction a verrouillée.
  • A lock_timeout expiré, généralement sur DDL tel que ALTER TABLE, ce qui nécessite un verrou exclusif et attend derrière des requêtes longue durée.
  • Une transaction longue ou une session laissée inactive dans une transaction, qui détiennent des verrous.

Comment le corriger

  1. Trouvez la session qui détient le verrou.

    SELECT pid, usename, state, xact_start, query
    FROM pg_stat_activity
    WHERE pid IN (
        SELECT unnest(pg_blocking_pids(pid)) FROM pg_stat_activity
    );
  2. Pour les files d'attente de tâches, ignorez les lignes verrouillées au lieu d'échouer.

    SELECT id FROM jobs
    WHERE status = 'queued'
    ORDER BY id
    LIMIT 10
    FOR UPDATE SKIP LOCKED;
  3. Pour les modifications de schéma, utilisez un court lock_timeout délibérément et réessayez, afin que le ALTER ne se met pas en file d'attente derrière une longue requête et ne bloque pas tout le monde.

    SET lock_timeout = '3s';
    ALTER TABLE orders ADD COLUMN note text;
  4. Terminez ou raccourcissez la transaction bloquante ; si elle a été abandonnée, mettez-y fin.

    SELECT pg_terminate_backend(12345);  -- the blocking pid

Reproduisez-le en toute sécurité

Exécutez dans deux connexions ; terminez la session 1 avec ROLLBACK ensuite.

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

Erreurs liées

Plus d'erreurs d'objet non dans l'état prérequis

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.