PostgreSQL 55P03: блокировка недоступна
Запрос блокировки не стал ждать: использован NOWAIT либо истёк lock_timeout, пока другая сессия держала конфликтующую блокировку.
- SQLSTATE
55P03- Имя
lock_not_available
Что это значит
Обычно PostgreSQL готов ждать блокировку столько, сколько потребуется. 55P03 означает, что оператору сказали не ждать: SELECT ... FOR UPDATE NOWAIT или LOCK TABLE ... NOWAIT немедленно завершаться с ошибкой, если блокировка занята, и когда lock_timeout задан, любой оператор завершается ошибкой, как только выждет это время. Тайм-аут блокировки сообщает canceling statement due to lock timeout с тем же кодом.
Другая сессия, удерживающая блокировку, не затрагивается. Внутри блока транзакции неудачный оператор прерывает транзакцию.
Распространённые причины
FOR UPDATE NOWAIT,FOR SHARE NOWAITилиLOCK TABLE ... NOWAITнаткнётся на строку или таблицу, заблокированную другой транзакцией.- A
lock_timeoutистёк, обычно на DDL, таком какALTER TABLE, который требует эксклюзивной блокировки и ждёт за длительными запросами. - Долгая транзакция или сеанс, простаивающий в транзакции, которая удерживает блокировки.
Как исправить
-
Найдите сеанс, который удерживает блокировку.
SELECT pid, usename, state, xact_start, query FROM pg_stat_activity WHERE pid IN ( SELECT unnest(pg_blocking_pids(pid)) FROM pg_stat_activity ); -
Для очередей заданий пропускайте заблокированные строки вместо того, чтобы падать с ошибкой.
SELECT id FROM jobs WHERE status = 'queued' ORDER BY id LIMIT 10 FOR UPDATE SKIP LOCKED;
-
Для изменений схемы используйте короткий
lock_timeoutнамеренно и повторите попытку, так чтоALTERне будет стоять в очереди за длинным запросом и блокировать всех остальных.SET lock_timeout = '3s'; ALTER TABLE orders ADD COLUMN note text;
-
Завершите или сократите блокирующую транзакцию; если она брошена, завершите её принудительно.
SELECT pg_terminate_backend(12345); -- the blocking pid
Безопасное воспроизведение
Выполняйте в двух соединениях; по завершении закройте сеанс 1 командой 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"
Связанные ошибки
40P01обнаружена взаимная блокировка57014отмена инструкции55006объект используется1222SQL Server: истекло время ожидания запроса блокировки1205MySQL: Превышено время ожидания блокировки3572MySQL: Не удалось получить блокировку с NOWAITORA-00054Oracle: ресурс занят, и запрошено получение с NOWAITSQLITE_BUSYSQLite: база данных заблокирована
Больше ошибок «Объект не находится в требуемом состоянии»
Код и текст сообщения взяты из Документация PostgreSQL, приложение A: коды ошибок PostgreSQL. Смотрите весь Список ошибок PostgreSQL или поиск по всем ошибкам баз данных.
Работа с PostgreSQL в SQLly
Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.