CONFIGURATION PARAMETER锁管理
max_pred_locks_per_page
设置每页可保留的元组级谓词锁最大数量。
Sets the maximum number of predicate-locked tuples per page.
整数 重载生效 引入 10 现存至 20 devel 0 次默认值变更
版本轨迹
相对 PostgreSQL 17 无变化。
默认值变迁
默认值自 PostgreSQL 10 起没有变过。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
本版译文与 PostgreSQL 10 完全一致，下面就是同一段文字。
这个参数控制在谓词锁被提升为覆盖整个页面之前，该谓词锁能在单一页面上锁住多少行。默认值是2。这个参数只能在postgresql.conf文件中或者服务器命令行上设置。
机制详解
设置每页可保留的元组级谓词锁最大数量。重新加载配置即可应用新值；已经开始的工作不会被追溯改变。
Serializable Snapshot Isolation 在同一页的元组级谓词锁达到该数后提升为页级锁。提升可节省共享内存，却可能让无关写入看似冲突并增加 serialization failure。
应把 max_pred_locks_per_page 与 max_pred_locks_per_transaction、max_pred_locks_per_relation、default_transaction_isolation 一起监控和变更。先在对应角色与真实负载上验证，再按其 sighup context 选择会话修改、reload 或 restart；历史默认值并不等于当前有效值。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
从锁等待日志、涉及对象数量和并发上界校准 max_pred_locks_per_page；先修复过长事务与访问顺序，再增加共享内存或改变检测粒度。
-
OLAP分析与批处理
分区查询、批量 DDL 与 SERIALIZABLE 报表可能触及大量对象；用最坏计划验证，而不是只看平均事务。
-
小规格低配实例与开发机
保持默认通常足够。若提高启动时锁表参数，要同时核算 max_connections、prepared transactions 与备库一致性。
常见问题
- 把平均共享内存规划值当成单事务硬上限。
- 提高参数却不核算连接数与预备事务带来的乘数。
- 只扩容锁表，不修复长事务、对象访问顺序或分区爆炸。
- 忽略备库必须具备兼容的启动时锁容量。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 20 ← 19 沿用 19
事实沿用 19
-
PostgreSQL 10 ← 9.6 新增此参数
PostgreSQL 10 起可用
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
| 版本 | 默认值 | 单位 | 上下文 | 类型 | 最小值 | 最大值 | 枚举值 |
|---|---|---|---|---|---|---|---|
| 10 | 2 |
— |
重载生效 |
整数 |
0 |
2147483647 |
— |
| 11 | 2 |
— |
重载生效 |
整数 |
0 |
2147483647 |
— |
| 12 | 2 |
— |
重载生效 |
整数 |
0 |
2147483647 |
— |
| 13 | 2 |
— |
重载生效 |
整数 |
0 |
2147483647 |
— |
| 14 | 2 |
— |
重载生效 |
整数 |
0 |
2147483647 |
— |
| 15 | 2 |
— |
重载生效 |
整数 |
0 |
2147483647 |
— |
| 16 | 2 |
— |
重载生效 |
整数 |
0 |
2147483647 |
— |
| 17 | 2 |
— |
重载生效 |
整数 |
0 |
2147483647 |
— |
| 18 | 2 |
— |
重载生效 |
整数 |
0 |
2147483647 |
— |
| 19 | 2 |
— |
重载生效 |
整数 |
0 |
2147483647 |
— |
| 20 沿用 | 2 |
— |
重载生效 |
整数 |
0 |
2147483647 |
— |
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
deadlock_timeout |
整数 | 会话（超级用户） | 1 s |
9.22 次 | |
| 设置等待锁多久后开始检查死锁。 | 现存 | ||||
max_locks_per_transaction |
整数 | 重启生效 | 64 |
191 次 | |
| 设置每个事务的锁数量上限。 | 现存 | ||||
max_pred_locks_per_page |
整数 | 重载生效 | 2 |
— | |
| 设置每页可保留的元组级谓词锁最大数量。 | 现存 | ||||
max_pred_locks_per_relation |
整数 | 重载生效 | -2 |
— | |
| 设置每个关系可保留的页级和元组级谓词锁最大数量。 | 现存 | ||||
max_pred_locks_per_transaction |
整数 | 重启生效 | 64 |
— | |
| 设置每个事务的谓词锁最大数量。 | 现存 | ||||