CONFIGURATION PARAMETER资源消耗 / I/O
io_max_combine_limit
设置钳制 io_combine_limit 的服务器级上限。
Server-wide limit that clamps io_combine_limit.
整数 重启生效 引入 18 现存至 20 devel 0 次默认值变更
- 类型
- 整数integer
- 上下文
- 重启生效只能在服务器启动时设置，修改后需要重启
- 默认值
128 KiB (16 × 8kB)原始值 16 8kB- 取值范围
1 – 128- 分类
- 资源消耗 / I/O
- 引入版本
- 18
- 状态
- 现存
版本轨迹
PostgreSQL 18 新增此参数。
默认值变迁
默认值自 PostgreSQL 18 起没有变过。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
控制合并 I/O 操作时允许的最大 I/O 大小，并会静默限制用户可设置的参数 io_combine_limit。该参数只能在服务器启动时设置。 如果该值未指定单位，则按块计算，也就是 BLCKSZ 字节，通常为 8kB。 最大可能值取决于操作系统和块大小，但在 Unix 上通常为 1MB，在 Windows 上通常为 128kB。 默认值是 128kB。
机制详解
io_max_combine_limit 是服务器启动时确定的上限，会静默钳制用户可设置的 io_combine_limit，用于阻止请求尺寸超过服务器策略。
它控制合并操作的字节数，不控制队列深度。可行最大值取决于操作系统与 BLCKSZ，通常 Unix 为 1MB、Windows 为 128kB。
只把 io_combine_limit 提高到本值之上不会生效，必须同时提高这个启动参数。即便如此，没有相邻工作时合并请求仍可能更小。其 postmaster 上下文在服务器启动时固定取值，修改后必须重启。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
除非实测证明更大的合并请求能改善符合条件 I/O 且不伤害延迟，否则保留 PG18 服务器 clamp 128kB。io_combine_limit 仍较低时只提高本值没有变化，修改后还必须重启。
-
OLAP分析与批处理
更大的 clamp 只允许用户 combine 上限变大；它不会创造相邻 I/O，也不会增加并发。应有意设置两个参数，并测试实际请求尺寸、顺序吞吐与混合负载公平性。
-
小规格低配实例与开发机
小型或混合用途存储保留 128kB。不能用提高启动级全局尺寸上限来修复队列深度问题；后者属于并发控制。
常见问题
- 把服务器字节尺寸 clamp 误当成 I/O 并发上限。
- io_combine_limit 仍较低时提高 io_max_combine_limit，并期待行为改变。
- 没有相邻且符合条件的操作时仍期待更大的合并请求。
- 忽略操作系统与 BLCKSZ 限制，尤其是 Windows 通常更小的最大值。
- 忘记修改后必须重启服务器。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 20 ← 19 沿用 19
事实沿用 19
-
PostgreSQL 18 ← 17 新增此参数
PostgreSQL 18 起可用
逐版本快照
每个收录版本里的 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 并发度。 | 现存 | ||||