PostgreSQL / 系统课时

读取 pg_locks 锁记录

读取 pg_locks 锁记录

pg_stat_activity 能指出谁在等待,但要解释“持有什么锁、请求什么锁、锁对应哪个对象”,还要读取 pg_locks。本课聚焦关键字段,并把锁记录关联回会话与当前数据库对象。

学习目标

  • 读懂一条 pg_locks 记录中锁类型、模式和授予状态的含义
  • 根据 locktype 选择正确的对象标识字段
  • 把锁记录与 pg_stat_activity、pg_class 关联,识别真正的等待行

一条锁记录在表达什么

pg_locks 是集群级锁视图。一条记录表示某个后端已经持有或正在请求一个可由锁管理器表示的锁。阅读时先看三列:

  • locktype:锁定对象的类别,例如 relation、transactionid、virtualxid、page 或 tuple。
  • mode:请求的锁模式。模式是否冲突必须结合 locktype 和另一方的模式判断,不能只凭名称强弱排序。
  • granted:true 表示锁已经授予,false 表示这个请求正在等待。

对象字段只有在对应的 locktype 下才有意义,其余字段通常是 NULL。常见映射如下:

locktype 主要标识字段 解释
relation database、relation 数据库中的表、索引等 relation
page database、relation、page relation 内的块号
tuple database、relation、page、tuple 块内 tuple 位置
transactionid transactionid 某个事务 ID,常见于同行更新等待
virtualxid virtualxid 后端的虚拟事务 ID
object database、classid、objid、objsubid 由系统目录对象标识组成的锁

把锁记录关联回会话和对象

下面查询把当前数据库客户端会话的 relation 与 transactionid 锁拉到一起。对生产阻塞来说,这两类足以覆盖大量“表级锁已授予,但行更新仍在等另一个事务”的现场。

sql
SELECT
    l.pid,
    a.application_name,
    l.locktype,
    l.mode,
    l.granted,
    CASE
        WHEN c.oid IS NOT NULL
        THEN format('%I.%I', n.nspname, c.relname)
        ELSE NULL
    END AS relation_name,
    l.transactionid,
    l.waitstart,
    l.fastpath
FROM pg_locks AS l
JOIN pg_stat_activity AS a
  ON a.pid = l.pid
LEFT JOIN pg_class AS c
  ON c.oid = l.relation
 AND l.database = (
        SELECT oid
        FROM pg_database
        WHERE datname = current_database()
    )
LEFT JOIN pg_namespace AS n
  ON n.oid = c.relnamespace
WHERE a.datname = current_database()
  AND a.backend_type = 'client backend'
  AND l.locktype IN ('relation', 'transactionid')
ORDER BY l.pid, l.granted, l.locktype, l.mode;

预期结果

在两个会话更新同一行、会话 A 尚未提交时,关键行通常类似;实际环境还会出现其他 relation、虚拟事务或系统对象锁。

text
 pid     | application_name | locktype     | mode             | granted | relation_name   | transactionid | waitstart | fastpath
---------+------------------+--------------+------------------+---------+-----------------+---------------+-----------+---------
 <PID_A> | lock-lab-a       | relation     | RowExclusiveLock | t       | public.lock_lab |               |           | <BOOL>
 <PID_A> | lock-lab-a       | transactionid| ExclusiveLock    | t       |                 | <XID_A>       |           | f
 <PID_B> | lock-lab-b       | relation     | RowExclusiveLock | t       | public.lock_lab |               |           | <BOOL>
 <PID_B> | lock-lab-b       | transactionid| ShareLock        | f       |                 | <XID_A>       | <TIME>    | f

这组结果揭示了一个常见误区:两个会话都拿到了目标表的 RowExclusiveLock,并不代表它们不会互相阻塞。真正等待的是会话 B 对事务 <XID_A> 的 ShareLock 请求,而会话 A 正持有自己事务 ID 的 ExclusiveLock。

从 granted=false 还原阻塞关系

排查时先找 granted = false 的记录,再寻找“同一锁对象上与之冲突、且 granted = true”的持有者。对上面的 transactionid 例子,匹配键就是 transactionid = <XID_A>。

同一个 PID 同时出现多条 granted = true 很正常:一条 SQL 往往需要表锁、事务锁和其他内部锁。等待会话也不是“什么都没拿到”,它通常已经持有若干锁,只剩当前冲突请求尚未授予。

waitstart 记录当前这次锁等待开始的时间,可用于判断等待持续多久;fastpath = true 只表示该锁通过快速路径管理,不代表锁更弱,也不代表它不会参与冲突。

正确认识行锁与 tuple 记录

PostgreSQL 的行级锁信息主要写在数据行本身,不会像普通 relation 锁那样把每个已授予行锁完整列在 pg_locks 中。因此,同行 UPDATE 冲突经常表现为等待对方的 transactionid,而不是一条直观的“row lock = false”。

tuple 类型记录确实可能出现,但不要把它理解成“所有行锁的完整清单”。生产排查时,看到 transactionid 等待,再结合阻塞会话的 SQL、事务状态和目标 relation,通常比执着寻找 tuple 行更可靠。

把 pg_stat_activity 的“谁在等”与 pg_locks 的“等哪种锁、等哪个对象”合起来,就能从会话现象推进到具体锁请求,为后续构建完整阻塞链和判断解锁动作提供可靠证据。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

读取 pg_locks 锁记录

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通