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

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

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

CONFIGURATION PARAMETER资源消耗 / 工作进程

max_parallel_maintenance_workers

设置单次维护操作最多使用的并行工作进程数。

Sets the maximum number of parallel processes per maintenance operation.

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

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

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

版本轨迹

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

默认值变迁

2 11 – 20

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

手册说明

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

设置单一工具性命令能够启动的并行工作者的最大数目。 当前，支持使用并行工作者的工具性命令是CREATE INDEX，并且只有在构建B-树索引时才能并行，并且 VACUUM 没有 FULL选项。 并行工作者从由max_worker_processes创建的进程池中取出，数量由max_parallel_workers控制。 注意实际在运行时所请求数量的工作者可能不可用。如果发生这种情况，工具性操作将使用比预期数量少的工作者运行。默认值为2。将这个值设置为0可以禁用工具性命令对并行工作者的使用。

注意并行工具性命令不应该消耗比同等数量非并行操作更多的内存。这种策略与并行查询不同，并行查询的资源限制通常是应用在每个工作者进程上。并行工具性命令把资源限制maintenance_work_mem当作对整个工具性命令的限制，而不管其中用到了多少个并行工作者进程。不过，并行工具性命令实际上可能仍会消耗更多的CPU资源和I/O带宽。

机制详解

max_parallel_maintenance_workers 限制单条受支持维护命令（如并行 CREATE INDEX 或 VACUUM）请求的 worker 数；leader 另计且也可能参与工作。

该上限不会预留 worker，也不保证可获得。请求要在 max_parallel_workers 与 max_worker_processes 内竞争，具体操作规则还可能选择更少。

并行维护会放大 CPU 与 I/O 压力；CREATE INDEX 的内存采用维护专用计账方式，并非简单地给每个 worker 独立一份 maintenance_work_mem。其 user 上下文允许按会话或事务局部修改，之后执行或重新规划的工作会读取新值。

调优建议

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

  • OLTP在线事务处理

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

  • OLAP分析与批处理

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

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

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

常见问题

  • 把 max_parallel_maintenance_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 11 ← 10 新增此参数

    PostgreSQL 11 起可用

逐版本快照

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

版本 默认值单位上下文类型最小值最大值枚举值
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 是否也执行子计划。 现存