CONFIGURATION PARAMETER资源消耗 / I/O
maintenance_io_concurrency
设置维护操作可利用的存储 I/O 并发度。
A variant of "effective_io_concurrency" that is used for maintenance work.
整数 会话 引入 13 现存至 20 devel 1 次默认值变更
- 类型
- 整数integer
- 上下文
- 会话任何用户都可在会话内用 SET 修改
- 默认值
16- 取值范围
0 – 1000- 分类
- 资源消耗 / I/O
- 引入版本
- 13
- 状态
- 现存
版本轨迹
相对 PostgreSQL 17：默认值由 10 改为 16。
默认值变迁
默认值一共换过 2 档，每段的宽度按它覆盖的大版本数伸展，深色的一段是当前查看的 PostgreSQL 18。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
与effective_io_concurrency相似，但用于支持许多客户端会话完成的维护工作。
默认值是16。对于位于特定表空间中的表，可以通过设置同名的表空间参数覆盖该值（见ALTER TABLESPACE）。
机制详解
maintenance_io_concurrency 是代表许多客户端执行的维护工作所使用的单次维护操作存储并发目标。同名 tablespace 选项可针对该存储覆盖；它既不是集群级设备上限，也不是内存分配。
PG13–17 中它主要控制受支持系统上的维护预取。Linux-Docker 实测 boot 值为 10，缺少有效预取建议、因而不受支持的平台默认 0；这些版本没有 PG18 的核心 AIO 执行模型。
PostgreSQL 18 把该目标接入核心 AIO，boot 默认改为 16。io_max_concurrency 另行钳制单进程同时执行数量，io_method 选择执行机制，combine 参数控制每次请求字节数。其 user 上下文允许局部运行时修改。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
PG13–17 只应在受支持存储上把它作为维护预取目标调优；PG18 才把它作为 AIO 并发目标。VACUUM 等符合条件的维护运行时应测前台尾延迟，异构存储使用 tablespace 覆盖。
-
OLAP分析与批处理
高延迟、高 IOPS 存储上，提高维护并发可能缩短符合条件的扫描或 vacuum，也会加深分析查询看到的队列。应同时测试维护完成时间与混合负载延迟；它不会改变请求尺寸。
-
小规格低配实例与开发机
除非维护确实受 I/O 停顿限制，否则使用对应版本和平台的默认值。
常见问题
- 把 10 称为 PG13–17 无条件默认，忽略不支持平台使用 0。
- 把 PG18 核心 AIO 语义反向套到 PG13–17 的预取行为。
- 把单次操作目标误当成集群或设备总上限。
- 把并发度与 io_combine_limit 的每次请求字节数混为一谈。
- 对存储特性差异很大的 tablespace 使用同一取值。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 20 ← 19 沿用 19
事实沿用 19
-
PostgreSQL 18 ← 17 默认值变更
默认值
1016分类Resource Usage / Asynchronous BehaviorResource Usage / I/O补充说明（无）0 disables simultaneous requests. -
PostgreSQL 17 ← 16 仅描述更新
简述
A variant of effective_io_concurrency that is used for maintenance work.A variant of "effective_io_concurrency" that is used for maintenance work. -
PostgreSQL 13 ← 12 新增此参数
PostgreSQL 13 起可用
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| I/O 12 | |||||
backend_flush_after |
整数 | 会话 | 0 B (0 × 8kB) |
— | |
| 设置单个后端写出多少页面后请求操作系统下刷。 | 现存 | ||||
effective_io_concurrency |
整数 | 会话 | 16 |
181 次 | |
| 设置单个会话可高效利用的存储并发度。 | 现存 | ||||
io_combine_limit |
整数 | 会话 | 128 KiB (16 × 8kB) |
181 次 | |
| 限制合并读写操作的最大数据量。 | 现存 | ||||
io_max_combine_limit |
整数 | 重启生效 | 128 KiB (16 × 8kB) |
— | |
| 设置钳制 io_combine_limit 的服务器级上限。 | 现存 | ||||
io_max_concurrency |
整数 | 重启生效 | -1 |
— | |
| 设置单个进程可同时执行的最大 I/O 数。 | 现存 | ||||
io_max_workers |
整数 | 重载生效 | 8 |
— | |
| 设置 io_method=worker 时 I/O worker 进程的最大数量。 | 现存 | ||||
io_method |
枚举 | 重启生效 | worker |
— | |
| 选择 PostgreSQL 执行异步 I/O 操作的方法。 | 现存 | ||||
io_min_workers |
整数 | 重载生效 | 2 |
— | |
| 设置 io_method=worker 时 I/O worker 进程的最小数量。 | 现存 | ||||
io_worker_idle_timeout |
整数 | 重载生效 | 1 min |
— | |
| 设置 io_method=worker 时空闲 I/O worker 退出前的最长等待时间。 | 现存 | ||||
io_worker_launch_interval |
整数 | 重载生效 | 100 ms |
— | |
| 设置 io_method=worker 时启动新 I/O worker 的最小间隔。 | 现存 | ||||
io_workers |
整数 | 重载生效 | 3 |
— | |
| 设置 io_method=worker 时使用的 I/O 工作进程数。 | 于 19 移除 | ||||
maintenance_io_concurrency |
整数 | 会话 | 16 |
181 次 | |
| 设置维护操作可利用的存储 I/O 并发度。 | 现存 | ||||