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

安全に再現する

2つの接続で実行し、その後セッション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"

関連エラー

その他の「オブジェクトが前提条件の状態にない」エラー

コードとメッセージのテキストは、 PostgreSQL ドキュメントの付録 A: PostgreSQL エラーコード。全容は次で参照 PostgreSQL エラーリスト または すべてのデータベースエラーを検索.

// エラーが減り、修正も速く

SQLly で PostgreSQL を操作する

macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、PostgreSQL をはじめ、お使いの他のデータベースにも対応します。