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

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

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

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
引入版本
19
状态
现存

PostgreSQL 20 devel 手册 官方文档 引入提交 d1c01b79d4

版本轨迹

相对 PostgreSQL 19 无变化。 20 开发版尚未定稿:类型与说明取自手册,默认值、上下文和运行值尚未采样。

默认值变迁

2 19

仅记录了 PostgreSQL 19 的默认值。带单位的取值换算成了可读形式,原始的 boot_val 与单位写在悬浮提示里。

手册说明

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

设置 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 正式版发布后重新验证。

演化历史

相邻两个大版本之间的差异,新的在前。版本号链到该版的快照。

  1. PostgreSQL 19 ← 18 新增此参数

    PostgreSQL 19 起可用

逐版本快照

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

版本 默认值单位上下文类型最小值最大值枚举值
19 2 — 重载生效 整数 1 32 —
20 — — — 整数 — — —

参考资料

同类参数

参数 类型 上下文 默认值 版本变动 最近变更
Resource Usage 资源消耗 12 个 ↗
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 类似,但用于为多个客户端会话执行的维护工作。 现存