CONFIGURATION PARAMETER资源消耗 / 工作进程
max_worker_processes
设置并发后台工作进程的总上限。
Maximum number of concurrent worker processes.
整数 重启生效 引入 9.4 现存至 20 devel 0 次默认值变更
- 类型
- 整数integer
- 上下文
- 重启生效只能在服务器启动时设置，修改后需要重启
- 默认值
8- 取值范围
0 – 262143- 分类
- 资源消耗 / 工作进程
- 引入版本
- 9.4
- 状态
- 现存
版本轨迹
相对 PostgreSQL 17 仅简述或分类有更新。
默认值变迁
默认值自 PostgreSQL 9.4 起没有变过。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
设置系统能够支持的后台进程的最大数量。这个参数只能在服务器启动时设置。默认值为 8。
在运行一个备库时，你必须把这个参数设置为等于或者高于主库上的值。 否则，备库上可能不会允许查询。
在更改这个值时，考虑也对max_parallel_workers、max_parallel_maintenance_workers以及max_parallel_workers_per_gather进行调整。
机制详解
max_worker_processes 是并发后台 worker 的启动时总上限，包含并行 worker 与扩展管理的 worker，范围比 max_parallel_workers 更广。
该设置分配共享控制容量，但不会主动启动 worker。复制、扩展、逻辑 apply 与并行执行都可能依赖其下的名额。
备库通常应配置为不小于主库，因为 worker 需求可能在重放或提升后出现。没有 CPU 与内存预算时，提高它只会创造潜在并发。其 postmaster 上下文在服务器启动时固定取值，修改后必须重启。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
应根据并发预算而非仅凭 CPU 核数设置 max_worker_processes。保护延迟敏感 OLTP 不受报表与维护突发影响，并检查实际 Workers Planned 与 Workers Launched。
-
OLAP分析与批处理
分析负载可使用更大的 max_worker_processes，但要把每节点内存与 I/O 乘以并发语句数；应在真实 worker 竞争下测吞吐，而不是只测一条孤立查询。
-
小规格低配实例与开发机
小主机上应保守设置 max_worker_processes。更多潜在 worker 可能因上下文切换与内存压力降低总吞吐，即使一条查询变快。
常见问题
- 把 max_worker_processes 当作已预留容量，而不是与其他工作共享的上限。
- 忽略并行计划会放大 CPU、I/O 与受 work_mem 限制的节点。
- 只测一条查询，没有模拟并发 worker 竞争。
- 认为规划的 worker 数在执行时总能全部启动。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 20 ← 19 沿用 19
事实沿用 19
-
PostgreSQL 18 ← 17 仅描述更新
分类
Resource Usage / Asynchronous BehaviorResource Usage / Worker Processes -
PostgreSQL 9.6 ← 9.5 属性变更
最小值
10最大值8388607262143 -
PostgreSQL 9.4 ← 9.3 新增此参数
PostgreSQL 9.4 起可用
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
| 版本 | 默认值 | 单位 | 上下文 | 类型 | 最小值 | 最大值 | 枚举值 |
|---|---|---|---|---|---|---|---|
| 9.4 | 8 |
空 |
重启生效 |
整数 |
1 |
8388607 |
— |
| 9.5 | 8 |
— |
重启生效 |
整数 |
1 |
8388607 |
— |
| 9.6 | 8 |
— |
重启生效 |
整数 |
0 |
262143 |
— |
| 10 | 8 |
— |
重启生效 |
整数 |
0 |
262143 |
— |
| 11 | 8 |
— |
重启生效 |
整数 |
0 |
262143 |
— |
| 12 | 8 |
— |
重启生效 |
整数 |
0 |
262143 |
— |
| 13 | 8 |
— |
重启生效 |
整数 |
0 |
262143 |
— |
| 14 | 8 |
— |
重启生效 |
整数 |
0 |
262143 |
— |
| 15 | 8 |
— |
重启生效 |
整数 |
0 |
262143 |
— |
| 16 | 8 |
— |
重启生效 |
整数 |
0 |
262143 |
— |
| 17 | 8 |
— |
重启生效 |
整数 |
0 |
262143 |
— |
| 18 | 8 |
— |
重启生效 |
整数 |
0 |
262143 |
— |
| 19 | 8 |
— |
重启生效 |
整数 |
0 |
262143 |
— |
| 20 沿用 | 8 |
— |
重启生效 |
整数 |
0 |
262143 |
— |
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| 工作进程 5 | |||||
max_parallel_maintenance_workers |
整数 | 会话 | 2 |
— | |
| 设置单次维护操作最多使用的并行工作进程数。 | 现存 | ||||
max_parallel_workers |
整数 | 会话 | 8 |
— | |
| 设置集群内可同时活动的并行工作进程总数。 | 现存 | ||||
max_parallel_workers_per_gather |
整数 | 会话 | 2 |
101 次 | |
| 设置单个 Gather 节点最多请求的并行工作进程数。 | 现存 | ||||
max_worker_processes |
整数 | 重启生效 | 8 |
9.61 次 | |
| 设置并发后台工作进程的总上限。 | 现存 | ||||
parallel_leader_participation |
布尔 | 会话 | on |
— | |
| 控制 Gather 或 Gather Merge 的 leader 是否也执行子计划。 | 现存 | ||||