pgrowlocksモジュールは、指定したテーブルにおける行ロックの情報を示す関数を提供します。
デフォルトでは、使用は、スーパーユーザ、pg_stat_scan_tables権限を持つロール、そのテーブルのSELECT権限を持つユーザに限定されています。
pgrowlocks(text) returns setof record
パラメータはテーブルの名前です。 結果はレコードの集合となり、各レコードはテーブル内のロックされた1行を示します。 出力列は表 F.21の通りです。
表F.21 pgrowlocksの出力列
| 名前 | 型 | 説明 |
|---|---|---|
locked_row | tid | ロックされた行のタプルID（TID） |
locker | xid | ロックを獲得したトランザクションのトランザクションID、もしマルチトランザクションの場合はマルチトランザクションID。74.1を参照 |
multi | boolean | ロックをマルチトランザクションが獲得していた場合は真 |
xids | xid[] | ロックを獲得しているトランザクションのトランザクションID（マルチトランザクションの場合は複数） |
modes | text[] | ロックを獲得しているトランザクションのロックモード（マルチトランザクションの場合は複数）。Key Share, Share、For No Key Update、No Key Update、For Update、Updateの配列。 |
pids | integer[] | ロックを獲得しているバックエンドのプロセスID（マルチトランザクションの場合は複数） |
pgrowlocksは対象テーブルに対してAccessShareLockを獲得し、ロック情報の収集のために1行ずつ行を読み取ります。
これは大規模テーブルにおいては高速とは言えません。
以下に注意してください:
テーブルでACCESS EXCLUSIVEロックが獲得されている場合、pgrowlocksはブロックされます。
pgrowlocksでは、自己矛盾のないスナップショットを生成することは保証されません。
その実行中に、新しい行ロックが獲得されることも、古いロックが解放されることもあり得ます。
pgrowlocksは、ロックされた行の内容は表示しません。
同時に行の内容を参照したい場合には、以下のようにして実現することができます:
SELECT * FROM accounts AS a, pgrowlocks('accounts') AS p
WHERE p.locked_row = a.ctid;
しかし、こうした問い合わせが非常に非効率であることに注意してください。
=# SELECT * FROM pgrowlocks('t1');
locked_row | locker | multi | xids | modes | pids
------------+--------+-------+-------+----------------+--------
(0,1) | 609 | f | {609} | {"For Share"} | {3161}
(0,2) | 609 | f | {609} | {"For Share"} | {3161}
(0,3) | 607 | f | {607} | {"For Update"} | {3107}
(0,4) | 607 | f | {607} | {"For Update"} | {3107}
(4 rows)
Tatsuo Ishii