一、简介

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

• 并发冲突排查
• 行级锁等待分析
• 死锁前兆探测
• 热点数据行分析

二、安装与启用

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

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

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

CREATE EXTENSION pgrowlocks;

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

或者

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

三、功能作用

功能点	描述
查看行级锁持有者信息	包括事务 ID、锁模式、后台 PID 等
分析锁冲突或阻塞原因	判断是否存在热点行或锁竞争
融合pg_stat_activity	定位哪个语句/事务导致锁住了哪些行
多事务共享锁的诊断	支持显示多事务共持一行锁的情况

四、输出字段详解

执行：

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 使用）

1. 示例输出

SELECT * FROM pgrowlocks('orders');

可能返回如下内容：

locked_row | locker | multi |     xids     |    modes     |   pids

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

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

2. 字段详解

字段	示例	含义
locked_row	(0,5)	被加锁行在表中的物理位置
locker	123456	持锁事务的Transaction ID（主事务）
multi	f	表示该锁是否由多个事务共享
xids	{123456}	所有持锁事务ID
modes	{For Update}	锁的类型
pids	{2743}	加锁事务对应的后台进程号

五、典型用法示例

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、外部表等。

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

七、使用建议场景

场景	建议操作
排查热点行更新冲突	查询频繁锁定的ctid
联合pg_stat_activity定位阻塞	找到具体SQL和PID
多事务竞争插入同一行	查看multi=true的记录
预防死锁风险	分析事务是否访问相同行但不同顺序