跳转到主要内容

synchronous_commit

synchronous_commit：设置当前事务提交时使用的同步级别。实测在档范围为 PG9.0–19 Beta 3；最后在档的 PG19 Beta 3 启动默认值为 on，context 为 user。这是测试版快照事实，PostgreSQL 19 正式发布前仍可能变化。
说明

Fact — 官方简述译文：设置当前事务提交时使用的同步级别。

身份

类型 值enum
上游 pg_settings 类型
Context 值user
普通用户可在运行时修改
单位 值—
原始单位
范围 值—
最后在档版本的原始上下限
枚举值 值local, remote_write, remote_apply, on, off
非枚举类型记为 —
分类 值Write-Ahead Log / Settings
上游分类
最后 boot 值 值on
on

生命周期

Fact 值
首次观测 PG9.0（研究下界）
在档版本 PG9.0–19 Beta 3
移除版本 否
引入提交 不作断言：早于 PG9.0 研究边界
提交日期 —
Discussion —

默认值变迁

PG9.0–19 Beta 3 实测 boot 默认值
版本 原始 boot_val 单位 人类可读值
PG9.0–19 Beta 3 on — on

机制详解

除 off 外的所有模式都会等待本地 WAL 刷入持久存储。off 可以在本地持久化之前返回成功；崩溃可能丢失最近已确认的事务，但恢复后的数据库仍保持事务一致性，不会产生 fsync = off 那类结构损坏风险。

当 synchronous_standby_names 选定同步备库时，remote_write 等待备库接收并写入操作系统，on 等待备库持久化刷新，remote_apply 还要等待重放并对查询可见；local 只等待本地持久化。如果没有选中同步备库，这些远程模式不会增加远程保证。

事务采用提交开始时生效的值。应用可以对单个事务使用 SET LOCAL，使关键事务和可重建事务在同一服务器上采用不同持久性策略。

调优建议

提示

Advice。 以下建议是工作负载起点，必须用真实测量验证。

场景 建议
OLTP 全局默认保持 on。仅对明确可重建的事务使用 off；只有提交后必须立即在同步备库读到结果时才使用 remote_apply，并把网络往返和备库健康纳入延迟预算。
OLAP 可重复执行的批量导入可在事务内使用 off，前提是能够接受最后一小段未刷盘数据丢失并可重跑。目录变更、交接标记和对外宣布完成的记录仍应同步提交。
小规格 保持 on。小型系统通常得不到足以抵消语义风险的全局降级收益，应只优化个别非关键任务。

Pigsty 取值

以下值来自固定 8 核、32 GiB、100 GiB SSD 夹具，并按 PG19 Beta 3 渲染当前 Pigsty 模板；这不表示 Pigsty 当前支持该历史或测试版本。

模板 有效值 与上游 boot 比较 源表达式
OLTP 未修改 — —
OLAP 未修改 — —
CRIT 未修改 — —
TINY 未修改 — —
注意

Advice — 待人工复核。 当前 Pigsty 模板投影事实：OLTP: PG9.0–19 Beta 3 未修改；OLAP: PG9.0–19 Beta 3 未修改；CRIT: PG9.0–19 Beta 3 未修改；TINY: PG9.0–19 Beta 3 未修改。 未发现覆盖值，因此不推断 Pigsty 专属理由。

常见坑

  • 把 synchronous_commit = off 与 fsync = off 混为一谈；前者风险是近期数据丢失，不是结构损坏。
  • 没有选定同步备库时仍期待 remote_write、on 或 remote_apply 提供远程等待。
  • 使用 remote_write 却假设备库能抵御操作系统崩溃。
  • 同步备库不可用时没有 HA 处置方案，导致提交无限等待。
  • 连接池中使用会话级 SET 而未使用 SET LOCAL 或重置纪律，造成设置泄漏。

synchronous_standby_names · fsync · wal_writer_delay · wal_sync_method · commit_delay · wal_level

参考资料

最后修改 2026-09-11