F.29. pgrowlocks

F.29.1. 概述
F.29.2. 样例输出
F.29.3. 作者

pgrowlocks模块提供了一个函数来显示一个指定表的行锁定信息。

默认情况下,使用仅限于超级用户、pg_stat_scan_tables 角色的成员和在该表上拥有SELECT权限的用户。

F.29.1. 概述

pgrowlocks(text) 返回 setof record

参数是一个表的名称。结果是一个记录集合,其中每一行对应表中一个被锁定的行。输出列如表 F.21所示。

表 F.21. pgrowlocks 输出列

名称类型描述
locked_rowtid被锁定行的元组 ID(TID)
lockerxid持锁者的事务 ID,如果是多事务则为多事务 ID
multiboolean如果持锁者是一个多事务,则为真
xidsxid[]持锁者的事务 ID(如果是多事务则多于一个)
lock_typetext[]持锁者的锁模式(如果是多事务则多于一个),是一个Key ShareShareFor No Key UpdateNo Key UpdateFor UpdateUpdate组成的数组。
pidsinteger[]锁定后端的进程 ID(如果是多事务则多于一个)

pgrowlocks会为目标表加AccessShareLock并且一个一个读取每一行来收集行的锁定信息。这对于一个大表不是很快。注意:

  1. 如果表被其他人整体加上了排他锁,pgrowlocks将被阻塞。

  2. pgrowlocks不保证能产生一个自我一致的快照。在它执行期间,有可能加上一个新行锁,也有可能有旧行锁被释放。

pgrowlocks不显示被锁定行的内容。如果你想同时查看行内容,你可以这样做:

SELECT * FROM accounts AS a, pgrowlocks('accounts') AS p
  WHERE p.locked_row = a.ctid;

不过要注意,这样一个查询将非常低效。

F.29.2. 样例输出

test=# SELECT * FROM pgrowlocks('t1');
 locked_row | lock_type | locker | multi |   xids    |     pids
------------+-----------+--------+-------+-----------+---------------
      (0,1) | Shared    |     19 | t     | {804,805} | {29066,29068}
      (0,2) | Shared    |     19 | t     | {804,805} | {29066,29068}
      (0,3) | Exclusive |    804 | f     | {804}     | {29066}
      (0,4) | Exclusive |    804 | f     | {804}     | {29066}
(4 rows)

F.29.3. 作者

Tatsuo Ishii