PostgreSQL pgrowlocks 扩展详解-EW帮帮网

一、简介

pgrowlocks 是 PostgreSQL 官方提供的扩展模块，用于查看指定表中每一行当前的行级锁（Row Lock）信息。它非常适用于：

二、安装与启用

1. 安装前提（已包含在 postgresql-contrib 包中）：

对于大多数 PostgreSQL 安装环境，pgrowlocks 已预编译，无需手动编译。

2. 启用扩展（数据库级别）：

CREATE EXTENSION pgrowlocks;

每个数据库需单独创建一次扩展；

或者

在template1模版数据库中安装扩展，随后新建数据库自带pgrowlocks。

三、功能作用

四、输出字段详解

执行：

SELECT * FROM pgrowlocks('your_table');

将返回如下字段：

字段名	含义说明
locked_row	被加锁行的 ctid（元组标识符，形如 (block, offset)）
locker	加锁的事务 ID（XID）
multi	是否是多事务锁（即多事务持有此行锁）
xids	多事务下所有持锁事务的事务 ID 数组
modes	锁模式（如 'For Update'、'For Share' 等）
pids	加锁事务对应的后端进程 PID 数组（可结合 pg_stat_activity 使用）

SELECT * FROM pgrowlocks('orders');

可能返回如下内容：

locked_row | locker | multi |     xids     |    modes     |   pids

------------+--------+-------+--------------+--------------+---------

 (0,5)      | 123456 | f     | {123456}     | {For Update} | {2743}

2. 字段详解

五、典型用法示例

1. 查询表中当前被加锁的所有行：

SELECT * FROM pgrowlocks('orders');

2. 联合 pg_stat_activity 查锁住行的 SQL：

SELECT a.pid, a.query, a.state, r.locked_row, r.modes

FROM pgrowlocks('orders') r

JOIN pg_stat_activity a

ON a.pid = ANY(r.pids);

3. 排查是否存在多事务共享锁

SELECT * FROM pgrowlocks('orders') WHERE multi = true;

六、注意事项

· pgrowlocks 扫描整张表，可能会 引起性能影响，慎用在线业务环境！

· 只支持 Heap 表（普通表），不支持 TOAST、外部表等。

· 仅显示当前存在的锁，不是历史信息。

七、使用建议场景

PostgreSQL pgrowlocks 扩展详解