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

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

百科 / 配置参数 / 资源消耗

CONFIGURATION PARAMETER资源消耗 / 工作进程

max_parallel_workers_per_gather

设置单个 Gather 节点最多请求的并行工作进程数。

Sets the maximum number of parallel processes per executor node.

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

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

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

版本轨迹

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

默认值变迁

0 9.6 2 10 – 20

默认值一共换过 2 档，每段的宽度按它覆盖的大版本数伸展，深色的一段是当前查看的 PostgreSQL 18。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。

手册说明

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

设置单个 Gather 或 Gather Merge 节点能够启动的工作进程的最大数量。并行工作进程取自max_worker_processes建立的进程池，并受到max_parallel_workers的限制。注意，运行时实际可用的工作进程可能不足请求的数量。此时，计划会使用少于预期的工作进程运行，效率可能较低。默认值为 2。设为 0 会禁用并行查询执行。

注意，并行查询消耗的资源可能远多于非并行查询，因为每个工作进程都是完全独立的进程，对系统的影响大致相当于额外增加一个用户会话。选择此设置的值，以及配置其他控制资源使用的设置（如work_mem）时，都应考虑这一点。work_mem 等资源限制分别应用于每个工作进程，因此所有进程的总资源用量可能远高于单个进程通常的用量。例如，使用 4 个工作进程的并行查询，其 CPU 时间、内存、I/O 带宽等用量可能达到完全不使用工作进程的查询的 5 倍。

并行查询的更多信息参见第 15 章。

机制详解

max_parallel_workers_per_gather 限制单个 Gather 或 Gather Merge 节点最多请求多少个 worker。零会阻止通过这些节点执行并行查询，但不禁用其他后台 worker。

worker 不会预留，执行时可能因 max_parallel_workers 与 max_worker_processes 共享池而不足；leader 进程不计入本数值。

每个并行计划都可能放大受 work_mem 限制的节点、CPU 与 I/O 需求。规划器还会考虑 parallel_setup_cost 与 parallel_tuple_cost 后才决定是否请求。其 user 上下文允许按会话或事务局部修改，之后执行或重新规划的工作会读取新值。

调优建议

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

  • OLTP在线事务处理

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

  • OLAP分析与批处理

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

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

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

常见问题

  • 把 max_parallel_workers_per_gather 当作已预留容量，而不是与其他工作共享的上限。
  • 忽略并行计划会放大 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 默认值变更

    默认值 0 2

  4. PostgreSQL 9.6 ← 9.5 新增此参数

    PostgreSQL 9.6 起可用

逐版本快照

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

版本 默认值单位上下文类型最小值最大值枚举值
9.6 0 — 会话 整数 0 1024 —
10 2 — 会话 整数 0 1024 —
11 2 — 会话 整数 0 1024 —
12 2 — 会话 整数 0 1024 —
13 2 — 会话 整数 0 1024 —
14 2 — 会话 整数 0 1024 —
15 2 — 会话 整数 0 1024 —
16 2 — 会话 整数 0 1024 —
17 2 — 会话 整数 0 1024 —
18 2 — 会话 整数 0 1024 —
19 2 — 会话 整数 0 1024 —
20 沿用 2 — 会话 整数 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 是否也执行子计划。 现存