// PostgreSQL 오류 참조

PostgreSQL 55P03: 잠금 사용 불가

잠금 요청이 기다리지 않고 포기한 경우입니다: NOWAIT를 썼거나, 다른 세션이 충돌하는 잠금을 잡는 동안 lock_timeout이 만료되었습니다.

SQLSTATE
55P03
이름
lock_not_available
카테고리
객체가 필요한 상태에 있지 않음
오류 메시지
could not obtain lock on row in relation "orders"

의미

보통 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, 배타적 잠금이 필요해 오래 도는 쿼리 뒤에 줄 서야 합니다.
  • 잠금을 붙잡고 있는 긴 트랜잭션, 또는 트랜잭션 중에 방치된 세션.

해결 방법

  1. 잠금을 보유한 세션을 찾으세요.

    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. 작업 큐에서는 실패하는 대신 잠긴 행을 건너뛰세요.

    SELECT id FROM jobs
    WHERE status = 'queued'
    ORDER BY id
    LIMIT 10
    FOR UPDATE SKIP LOCKED;
  3. 스키마 변경에는 다음을 짧게 설정하세요: lock_timeout 를 짧게 잡아 의도적으로 재시도하세요. 그러면 ALTER 긴 쿼리 뒤에 대기열에 쌓여 다른 모든 사용자를 막지 않도록 합니다.

    SET lock_timeout = '3s';
    ALTER TABLE orders ADD COLUMN note text;
  4. 차단 원인인 트랜잭션을 끝내거나 짧게 줄이세요. 방치된 트랜잭션이라면 강제로 종료하세요.

    SELECT pg_terminate_backend(12345);  -- the blocking pid

안전하게 재현하세요

두 개의 연결에서 실행하고, 이후 ROLLBACK으로 세션 1을 종료하세요.

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

관련 오류

그 밖의 선행 상태가 아닌 객체 오류

코드와 메시지 텍스트의 출처는 다음과 같습니다 PostgreSQL 문서 부록 A: PostgreSQL 오류 코드. 전체 목록은 PostgreSQL 오류 목록 또는 모든 데이터베이스 오류 검색.

// 오류는 줄이고, 수정은 빠르게

SQLly에서 PostgreSQL 작업하기

스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. PostgreSQL은 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.