io_combine_limit
Fact — 官方简述译文：限制合并读写操作的最大数据量。
身份
生命周期
| Fact | 值 |
|---|---|
| 首次观测 | PG17 |
| 在档版本 | PG17–19 Beta 3 |
| 移除版本 | 否 |
| 引入提交 | 210622c60e1a — Provide vectored variant of ReadBuffer(). |
| 提交日期 | 2024-04-03 |
| Discussion | 讨论 1 |
默认值变迁
| 版本 | 原始 boot_val |
单位 | 人类可读值 |
|---|---|---|---|
| PG17–19 Beta 3 | 16 |
8kB |
128 KiB (16 × 8kB) |
机制详解
io_combine_limit 限制把相邻且符合条件的操作合并后形成的单次 I/O 请求字节数。它控制每次请求大小，不控制可同时执行的请求数量。
PostgreSQL 17 中它是独立的用户可设置合并尺寸上限，Linux-Docker 实测 boot 值为 128kB；该版本不存在 io_max_combine_limit。PostgreSQL 18 中，有效尺寸是 io_combine_limit 与新启动参数 io_max_combine_limit 的较小者。
没有足够相邻工作时，实际请求可以更小；操作系统与 BLCKSZ 还会限制可行最大值。其 user 上下文允许按会话或事务修改；改变它不会改变 io_max_concurrency 或 worker 数。
调优建议
Advice。 以下建议是工作负载起点，必须用真实测量验证。
| 场景 | 建议 |
|---|---|
| OLTP | 在基准证明瓶颈确实来自合并请求尺寸而非队列深度前，保留对应版本默认值。PG18 必须同时核对 io_combine_limit 与 io_max_combine_limit，并在真实并发下测量尾延迟。 |
| OLAP | 更大的合并请求可在符合条件的顺序工作中减少系统调用，但也可能增加单次服务时间并降低公平性。应比较吞吐、延迟与实际请求尺寸，不能只按设备队列深度推导取值。 |
| 小规格 | 除非相邻 I/O 的实测结果证明其他尺寸更好，否则保留 128kB。PG18 中只把 io_combine_limit 提高到 clamp 之上不会生效；PG17 则没有独立 clamp GUC。 |
Pigsty 取值
以下值来自固定 8 核、32 GiB、100 GiB SSD 夹具，并按 PG19 Beta 3 渲染当前 Pigsty 模板；这不表示 Pigsty 当前支持该历史或测试版本。
| 模板 | 有效值 | 与上游 boot 比较 | 源表达式 |
|---|---|---|---|
| OLTP | 未修改 | — | — |
| OLAP | 未修改 | — | — |
| CRIT | 未修改 | — | — |
| TINY | 未修改 | — | — |
Advice — 待人工复核。 当前 Pigsty 模板投影事实：OLTP: PG17–19 Beta 3 未修改；OLAP: PG17–19 Beta 3 未修改；CRIT: PG17–19 Beta 3 未修改；TINY: PG17–19 Beta 3 未修改。 未发现覆盖值，因此不推断 Pigsty 专属理由。
常见坑
- 把 PG18 的 io_max_combine_limit clamp 套到不存在该 GUC 的 PostgreSQL 17。
- 把字节尺寸上限误当成 I/O 并发度或队列深度。
- 把 io_combine_limit 提高到 PG18 服务器 clamp 之上，并期待请求继续变大。
- 认为每个符合条件的操作都一定达到配置尺寸，即使没有足够相邻 I/O。
关联参数
io_max_combine_limit · io_max_concurrency · io_method · effective_io_concurrency · maintenance_io_concurrency