↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3
历史版本。 PostgreSQL 9.1 已结束支持。 2016-10-27. 请参阅 当前版本手册.

F.30. pgrowlocks — 显示表的行锁信息 #

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

F.30.1. 概述

pgrowlocks(text) returns setof record

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

表 F.21. pgrowlocks 输出列

NameTypeDescription
locked_rowtidTuple ID (TID) of locked row
lock_typetextShared for shared lock, or Exclusive for exclusive lock
lockerxidTransaction ID of locker, or multixact ID if multi-transaction
multibooleanTrue if locker is a multi-transaction
xidsxid[]Transaction IDs of lockers (more than one if multi-transaction)
pidsinteger[]Process IDs of locking backends (more than one if multi-transaction)

pgrowlocks 会对目标表获取 AccessShareLock,并逐行读取以收集行锁信息。对于大表,这样做速度并不快。请注意:

  1. 如果整张表被其他人独占锁定,pgrowlocks 将被阻塞。

  2. pgrowlocks 并不保证给出一个自一致快照。在其执行期间,可能会有新的行锁被获取,也可能有旧的锁被释放。

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

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

不过要注意,(截至 PostgreSQL 8.3)这样的查询效率会很低。

F.30.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.30.3. 作者

Tatsuo Ishii

报告文档问题

阅读 上游文档. 反馈更正前请先核对 当前版本手册.