処理時間ではなく取得待ちの期限
PostgreSQLのlock_timeoutは、ロックの取得待ちが設定時間を超えた場合に文を中止する設定です。クエリ全体の実行時間を制限するstatement_timeoutとは対象が違います。ロックタイムアウトは、データが壊れたことやデッドロックが成立したことを直接意味しません。長いトランザクション、管理用DDL、同じ行への更新集中など、必要なロックがすぐに取得できない理由を調べるための手掛かりです。
二つの更新が同じ行で待つ例
セッションAがBEGIN後に口座行を更新し、COMMITせず停止しているとします。セッションBが同じ行を更新すれば、Aの終了を待つことがあります。BにSET LOCAL lock_timeout = '2s'を設定した検証用トランザクションなら、待ちが続くとエラーになります。二秒は説明用の値で、サービスへそのまま推奨する設定ではありません。エラーを早く返すことと、競合を解消して仕事を成功させることは別の判断です。
BEGIN;
SET LOCAL lock_timeout = '2s';
-- Controlled test only: may wait for another transaction.
UPDATE accounts SET balance = balance + 1 WHERE id = 1;
ROLLBACK;誰が誰を待たせるか確認する
pg_stat_activityの状態と待機イベントを見て、pg_blocking_pidsで対象の阻害者を調べます。ロック情報はpg_locksでも確認できますが、行ロックの待ちが常に行単位の一覧として見えるとは限りません。先にトランザクションの開始時刻、実行中またはidle in transactionの状態、対象処理の責任者を確認します。単に一番古いPIDを終了すると、重要な仕事のロールバックや利用者への影響を大きくする場合があります。
中止後のトランザクションを扱う
エラー後に同じトランザクションを使い続ける場合は、失敗状態を適切に解消する必要があります。通常はトランザクション全体をROLLBACKするか、設計済みのSAVEPOINTへ戻します。再試行するなら処理の冪等性と再実行範囲を明確にし、上限と待ち時間を設けます。ロックの取得順をそろえ、トランザクション中の外部I/Oを短くする対策も検討します。タイムアウト値を大きくするだけでは、待ちの原因や接続の占有は残ります。