CONFIGURATION PARAMETER资源消耗 / I/O
io_min_workers
设置 I/O 工作进程的最小数量。
Minimum number of I/O worker processes, for io_method=worker.
整数 引入 19 现存至 20 devel 0 次默认值变更 开发版
- 类型
- 整数integer
- 分类
- 资源消耗 / I/O
- 引入版本
- 19
- 状态
- 现存
版本轨迹
相对 PostgreSQL 19 无变化。 20 开发版尚未定稿:类型与说明取自手册,默认值、上下文和运行值尚未采样。
默认值变迁
仅记录了 PostgreSQL 19 的默认值。带单位的取值换算成了可读形式,原始的 boot_val 与单位写在悬浮提示里。
手册说明
设置 I/O 工作进程的最小数量。默认值为 2。此参数只能在
postgresql.conf 文件中或服务器命令行中设置。
仅当 io_method 设置为 worker 时才有效。
机制详解
io_min_workers:设置 io_method=worker 时 I/O worker 进程的最小数量。重新加载配置即可让服务器采用新值,无需完整重启。 本站在 PG19 Beta 3 实测到它;boot_val 是编译或初始化基线,并不能证明某个运行集群的当前有效值。
这组参数只管理 io_method=worker 时使用的弹性后台 worker 池。io_min_workers 保留热容量,io_max_workers 限制池上限,io_worker_launch_interval 抑制短暂突发造成的过度启动,io_worker_idle_timeout 回收空闲进程;它们不会提高单个后端独立的 io_max_concurrency 上限。
应与 io_max_workers、io_worker_idle_timeout、io_worker_launch_interval、io_method 一起理解。请在目标服务器检查 SHOW 与 pg_settings,确认 source 和 pending_restart,并在修改前后对比真实负载、日志和资源指标。
调优建议
按典型负载给出的取值思路,不是放之四海皆准的配方:实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
必须在生产存储栈与真实并发下测试,优化尾延迟和队列深度,而不只看平均吞吐,并为 WAL、检查点与前台读取保留容量。
-
OLAP分析与批处理
使用有代表性的扫描、预取与落盘阶段;只有吞吐继续提升且 CPU、内存与存储没有不可接受的饱和时,才增加并发或 worker 容量。
-
小规格低配实例与开发机
优先采用 auto 或上游 worker 上限,并按场景使用 pg_test_timing 或 I/O 统计验证;小节点上的大进程池可能只增加上下文切换。
常见问题
- 把 io_min_workers 的实测 boot_val 当成初始化后或托管集群当前有效值的证明。
- 忽略 pg_settings 报告的 sighup context,误以为修改会立即生效。
- 孤立修改该参数,没有检查关联上限、可观测性和回滚路径。
- 在生产中依赖测试版行为,却没有在 PostgreSQL 19 正式版发布后重新验证。
演化历史
相邻两个大版本之间的差异,新的在前。版本号链到该版的快照。
-
PostgreSQL 19 ← 18 新增此参数
PostgreSQL 19 起可用
逐版本快照
每个收录版本里的 7 项事实,与上一个存在的版本不同的格子带底色。版本号链到该版。
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| I/O 12 | |||||
backend_flush_after |
整数 | 会话 | 0 B (0 × 8kB) |
— | |
| 每当单个后端写出的数据超过此数量时,就尝试强制操作系统将这些写操作发往底层存储。 | 现存 | ||||
effective_io_concurrency |
整数 | 会话 | 16 |
181 次 | |
| 设置 PostgreSQL 预期可以同时执行的并发存储 I/O 操作数量。 | 现存 | ||||
io_combine_limit |
整数 | 会话 | 128 KiB (16 × 8kB) |
181 次 | |
| 控制合并 I/O 操作时允许的最大 I/O 大小。 | 现存 | ||||
io_max_combine_limit |
整数 | 重启生效 | 128 KiB (16 × 8kB) |
— | |
| 控制合并 I/O 操作时允许的最大 I/O 大小,并会静默限制用户可设置的参数 io_combine_limit。 | 现存 | ||||
io_max_concurrency |
整数 | 重启生效 | -1 |
— | |
| 控制一个进程可以同时执行的最大 I/O 操作数。 | 现存 | ||||
io_max_workers |
整数 | — | — | ||
| 设置 I/O 工作进程的最大数量。 | 现存 | ||||
io_method |
枚举 | 重启生效 | worker |
— | |
| 选择执行异步 I/O 的方法。 | 现存 | ||||
io_min_workers |
整数 | — | — | ||
| 设置 I/O 工作进程的最小数量。 | 现存 | ||||
io_worker_idle_timeout |
整数 | — | — | ||
| 设置完全空闲的 I/O 工作进程退出前经过的时间,从而将池大小缩减到与需求匹配。 | 现存 | ||||
io_worker_launch_interval |
整数 | — | — | ||
| 设置启动另一个 I/O 工作进程之前的最短时间。 | 现存 | ||||
io_workers |
整数 | 重载生效 | 3 |
— | |
| 选择要使用的 I/O 工作进程数量。 | 于 19 移除 | ||||
maintenance_io_concurrency |
整数 | 会话 | 16 |
181 次 | |
| 与 effective_io_concurrency 类似,但用于为多个客户端会话执行的维护工作。 | 现存 | ||||