CONFIGURATION PARAMETER预写式日志 / 设置

commit_delay

设置事务提交与将 WAL 刷入磁盘之间的延迟（微秒）。

Sets the delay in microseconds between transaction commit and flushing WAL to disk.

整数会话（超级用户）引入 9.0（基线）现存至 20 devel 0 次默认值变更

类型: 整数integer
上下文: 会话（超级用户）超级用户可在会话内用 SET 修改
默认值: 0
取值范围: 0 – 100000
分类: 预写式日志 / 设置
引入版本: 9.0（基线）
状态: 现存

PostgreSQL 18 手册官方文档

版本轨迹

相对 PostgreSQL 17 无变化。

默认值变迁

0 9.0 – 20

默认值自 PostgreSQL 9.0 起没有变过。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。

手册说明

PostgreSQL 18 手册 · 19.5 预写式日志本站手册官方原文

本版译文与 PostgreSQL 16 完全一致，下面就是同一段文字。

设置commit_delay会在执行WAL刷新之前添加时间延迟。如果系统负载足够高，使得在给定时间间隔内有更多事务准备提交，这可以通过允许更多事务通过单个WAL刷新来提高组提交吞吐量。然而，这也会增加延迟，最多为每个WAL刷新的commit_delay。因为如果没有其他事务准备提交，延迟就是浪费的，所以只有在至少有 commit_siblings其他事务活动时才会执行延迟，当要启动刷新时，如果fsync被禁用，则不会执行延迟。如果未指定单位，则将其视为微秒。默认commit_delay为零（无延迟）。只有超级用户和具有适当SET权限的用户才能更改此设置。

在PostgreSQL的 9.3 发布之前，commit_delay的行为不同并且效果更差：它只影响提交，而不是所有 WAL 刷写，并且即使在 WAL 刷写马上就要完成时也会等待一整个配置的延迟。从PostgreSQL 9.3 中开始，第一个准备好刷写的进程会等待配置的间隔，而后续的进程只等到领先者完成刷写操作。

机制详解

设置事务提交与将 WAL 刷入磁盘之间的延迟（微秒）。超级用户或获授 SET 权限的角色可在相应的会话或配置作用域中修改它。

后端准备刷提交 WAL 时可等待这些微秒，让并发提交共用一次持久化刷写；只有至少存在 commit_siblings 个其他活动事务时才考虑等待。这是在单次提交延迟与 group commit 效率之间取舍。

应把 commit_delay 与 commit_siblings、synchronous_commit、wal_writer_delay 一起监控和变更。先在对应角色与真实负载上验证，再按其 superuser context 选择会话修改、reload 或 restart；历史默认值并不等于当前有效值。

调优建议

按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。

OLTP在线事务处理

只在高并发、WALSync 明显且 p95/p99 提交延迟可接受时基准测试 commit_delay；同时成对调整 commit_delay 与 commit_siblings，并保留关闭基线。
OLAP分析与批处理

批量事务通常应通过合理批次大小减少提交频率；不要用 group-commit 延迟弥补每行提交的 ETL 设计。
小规格低配实例与开发机

并发不足时几乎没有收益，保持 commit_delay=0 最简单；微秒级设置也要从端到端延迟测量证明。

常见问题

设置了延迟，但真实并发从未达到 commit_siblings 门槛。
把数值误读成毫秒；该参数单位是微秒。
平均 group commit 吞吐提高，却违反 p95/p99 提交延迟目标。
在提交路径无需刷 WAL 时仍期待该延迟生效。
没有与 commit_siblings、WALSync 等待一起测量就修改 commit_delay。

演化历史

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

PostgreSQL 20 ← 19 沿用 19

事实沿用 19
PostgreSQL 9.3 ← 9.2 属性变更

上下文 会话 会话（超级用户）

逐版本快照

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

版本	默认值	单位	上下文	类型	最小值	最大值	枚举值
9.0	`0`	`空`	`会话`	`整数`	`0`	`100000`	`—`
9.1	`0`	`空`	`会话`	`整数`	`0`	`100000`	`—`
9.2	`0`	`空`	`会话`	`整数`	`0`	`100000`	`—`
9.3	`0`	`空`	`会话（超级用户）`	`整数`	`0`	`100000`	`—`
9.4	`0`	`空`	`会话（超级用户）`	`整数`	`0`	`100000`	`—`
9.5	`0`	`—`	`会话（超级用户）`	`整数`	`0`	`100000`	`—`
9.6	`0`	`—`	`会话（超级用户）`	`整数`	`0`	`100000`	`—`
10	`0`	`—`	`会话（超级用户）`	`整数`	`0`	`100000`	`—`
11	`0`	`—`	`会话（超级用户）`	`整数`	`0`	`100000`	`—`
12	`0`	`—`	`会话（超级用户）`	`整数`	`0`	`100000`	`—`
13	`0`	`—`	`会话（超级用户）`	`整数`	`0`	`100000`	`—`
14	`0`	`—`	`会话（超级用户）`	`整数`	`0`	`100000`	`—`
15	`0`	`—`	`会话（超级用户）`	`整数`	`0`	`100000`	`—`
16	`0`	`—`	`会话（超级用户）`	`整数`	`0`	`100000`	`—`
17	`0`	`—`	`会话（超级用户）`	`整数`	`0`	`100000`	`—`
18	`0`	`—`	`会话（超级用户）`	`整数`	`0`	`100000`	`—`
19	`0`	`—`	`会话（超级用户）`	`整数`	`0`	`100000`	`—`
20 沿用	`0`	`—`	`会话（超级用户）`	`整数`	`0`	`100000`	`—`

参考资料

同类参数

参数	类型	上下文	默认值	最近变更
Write-Ahead Log 预写式日志 15 个 ↗
设置 15
`commit_delay`	整数	会话（超级用户）	`0`	9.31 次
设置事务提交与将 WAL 刷入磁盘之间的延迟（微秒）。				现存
`commit_siblings`	整数	会话	`5`	9.11 次
设置启用 commit_delay 前所需的并发活动事务最低数量。				现存
`fsync`	布尔	重载生效	`on`	—
强制将更新同步到磁盘。				现存
`full_page_writes`	布尔	重载生效	`on`	—
检查点后页面首次修改时将完整页面写入 WAL。				现存
`synchronous_commit`	枚举	会话	`on`	9.63 次
设置当前事务提交时使用的同步级别。				现存
`wal_buffers`	整数	重启生效	`-1 8kB`	9.11 次
设置共享内存中用于 WAL 的磁盘页缓冲区数量。				现存
`wal_compression`	枚举	会话（超级用户）	`off`	151 次
使用指定方法压缩写入 WAL 的整页映像。				现存
`wal_init_zero`	布尔	会话（超级用户）	`on`	—
新 WAL 文件首次使用前先写零。				现存
`wal_level`	枚举	重启生效	`replica`	103 次
设置写入 WAL 的信息级别。				现存
`wal_log_hints`	布尔	重启生效	`off`	—
页面在检查点后首次发生非关键修改时也将完整页面写入 WAL。				现存
`wal_recycle`	布尔	会话（超级用户）	`on`	—
通过重命名复用 WAL 文件。				现存
`wal_skip_threshold`	整数	会话	`2 MiB`	—
设置用 fsync 新文件代替写 WAL 的最小文件规模。				现存
`wal_sync_method`	枚举	重载生效	`fdatasync`	—
选择将 WAL 更新强制写入磁盘的方法。				现存
`wal_writer_delay`	整数	重载生效	`200 ms`	—
设置 WAL writer 两次刷写之间的时间。				现存
`wal_writer_flush_after`	整数	重载生效	`1 MiB (128 × 8kB)`	—
设置触发 WAL writer 刷盘的写出 WAL 数量。				现存

快速链接