↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译，由 Pigsty 团队维护。

文档 / 配置参数 / 资源消耗

CONFIGURATION PARAMETER资源消耗 / 工作进程

max_parallel_workers

设置集群内可同时活动的并行工作进程总数。

Sets the maximum number of parallel workers that can be active at one time.

整数 会话 引入 10 现存至 20 devel 0 次默认值变更

类型
整数integer
上下文
会话任何用户都可在会话内用 SET 修改
默认值
8
取值范围
0 – 1024
分类
资源消耗 / 工作进程
引入版本
10
状态
现存

PostgreSQL 18 手册 官方文档 引入提交 b460f5d669

版本轨迹

相对 PostgreSQL 17 仅简述或分类有更新。

默认值变迁

8 10 – 20

默认值自 PostgreSQL 10 起没有变过。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。

手册说明

PostgreSQL 18 手册 · 19.4 资源消耗 本站手册 官方原文

设置系统为并行操作所支持的工作者的最大数量。默认值为8。 在增加或者减小这个值时，也要考虑对max_parallel_maintenance_workers以及max_parallel_workers_per_gather进行调整。 此外，要注意将这个值设置得大于max_worker_processes将不会产生效果，因为并行工作者进程都是从max_worker_processes所建立的工作者进程池中取出来的。

机制详解

max_parallel_workers 限制全集群同时活动的并行查询与维护 worker 数，是 max_worker_processes 之下的池上限。

单次操作参数从该池请求 worker，但不会预留名额。计划可能以少于规划数量的 worker 启动，并发任务也会互相争抢。

提高它会扩大潜在 CPU、内存与 I/O 并发，却不会自行让计划并行；规划阈值、安全检查与 max_parallel_workers_per_gather 仍决定查询选择。其 user 上下文允许按会话或事务局部修改，之后执行或重新规划的工作会读取新值。

调优建议

按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。

  • OLTP在线事务处理

    应根据并发预算而非仅凭 CPU 核数设置 max_parallel_workers。保护延迟敏感 OLTP 不受报表与维护突发影响，并检查实际 Workers Planned 与 Workers Launched。

  • OLAP分析与批处理

    分析负载可使用更大的 max_parallel_workers，但要把每节点内存与 I/O 乘以并发语句数；应在真实 worker 竞争下测吞吐，而不是只测一条孤立查询。

  • 小规格低配实例与开发机

    小主机上应保守设置 max_parallel_workers。更多潜在 worker 可能因上下文切换与内存压力降低总吞吐，即使一条查询变快。

常见问题

  • 把 max_parallel_workers 当作已预留容量，而不是与其他工作共享的上限。
  • 忽略并行计划会放大 CPU、I/O 与受 work_mem 限制的节点。
  • 只测一条查询，没有模拟并发 worker 竞争。
  • 认为规划的 worker 数在执行时总能全部启动。

演化历史

相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。

  1. PostgreSQL 20 ← 19 沿用 19

    事实沿用 19

  2. PostgreSQL 18 ← 17 仅描述更新

    分类 Resource Usage / Asynchronous Behavior Resource Usage / Worker Processes

  3. PostgreSQL 10 ← 9.6 新增此参数

    PostgreSQL 10 起可用

逐版本快照

每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。

版本 默认值单位上下文类型最小值最大值枚举值
10 8 — 会话 整数 0 1024 —
11 8 — 会话 整数 0 1024 —
12 8 — 会话 整数 0 1024 —
13 8 — 会话 整数 0 1024 —
14 8 — 会话 整数 0 1024 —
15 8 — 会话 整数 0 1024 —
16 8 — 会话 整数 0 1024 —
17 8 — 会话 整数 0 1024 —
18 8 — 会话 整数 0 1024 —
19 8 — 会话 整数 0 1024 —
20 沿用 8 — 会话 整数 0 1024 —

参考资料

同类参数

参数 类型 上下文 默认值 版本变动 最近变更
Resource Usage 资源消耗 5 个 ↗
工作进程 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 是否也执行子计划。 现存