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

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–20 之间未变。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。

手册说明

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

设置单个工具命令能够启动的并行工作进程的最大数量。目前，支持使用并行工作进程的工具命令包括：构建 B-树、GIN 或 BRIN索引时的 CREATE INDEX，以及不带 FULL 选项的 VACUUM。并行工作进程取自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 是否也执行子计划。 现存