CONFIGURATION PARAMETER预写式日志 / 设置
fsync
强制将更新同步到磁盘。
Forces synchronization of updates to disk.
布尔 重载生效 引入 9.0（基线） 现存至 20 devel 0 次默认值变更
- 类型
- 布尔bool
- 上下文
- 重载生效改配置文件后重载（pg_ctl reload / SIGHUP）即可生效
- 默认值
on- 分类
- 预写式日志 / 设置
- 引入版本
- 9.0（基线）
- 状态
- 现存
版本轨迹
相对 PostgreSQL 17 无变化。
默认值变迁
默认值自 PostgreSQL 9.0 起没有变过。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
如果打开这个参数，PostgreSQL服务器将尝试确保更新被物理地写入到磁盘，做法是发出fsync()系统调用或者使用多种等价的方法（见wal_sync_method）。这保证了数据库集簇在一次操作系统或者硬件崩溃后能恢复到一个一致的状态。
虽然关闭fsync常常可以得到性能上的收益，但当发生断电或系统崩溃时可能造成不可恢复的数据损坏。因此，只有在能很容易地从外部数据中重建整个数据库时才建议关闭fsync。
能安全关闭fsync的环境的示例包括从一个备份文件中初始加载一个新数据库集簇、使用一个数据库集簇来在数据库被删掉并重建之后处理一批数据，或者一个被经常重建并却不用于失效备援的只读数据库克隆。单独的高质量硬件不足以成为关闭fsync的理由。
当把fsync从关闭改成打开时，为了可靠的恢复，需要强制在内核中的所有被修改的缓冲区进入持久化存储。这可以在多个时机来完成： 在集簇被关闭时或在fsync因为运行initdb --sync-only而打开时、运行sync时、卸载文件系统时或者重启服务器时。
在很多情况下，为不重要的事务关闭synchronous_commit可以提供很多关闭fsync的潜在性能收益，并不会有的同时， 关闭fsync可以提供很多潜在的性能优势，而不会有伴随着的数据损坏风险。
fsync只能在postgresql.conf文件中或在服务器命令行上设置。如果你关闭这个参数，请也考虑关闭full_page_writes。
机制详解
强制将更新同步到磁盘。重新加载配置即可应用新值；已经开始的工作不会被追溯改变。
开启时，PostgreSQL 发出持久化屏障，保证 WAL 与数据写入顺序能承受操作系统或掉电故障。关闭可能改善写入跑分，但崩溃后会留下 crash recovery 无法修复的损坏；重新开启也不能追溯同步此前的不安全写入。
应把 fsync 与 data_sync_retry、restart_after_crash、recovery_init_sync_method 一起监控和变更。先在对应角色与真实负载上验证，再按其 sighup context 选择会话修改、reload 或 restart；历史默认值并不等于当前有效值。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
持久生产数据保持 fsync=on。性能问题应从存储延迟、检查点、WAL 压缩和批处理着手，不要用关闭崩溃安全换吞吐。
-
OLAP分析与批处理
批量装载同样需要可恢复性；用 UNLOGGED/临时数据结构或可重建 staging 明确缩小耐久范围，而不是全局关闭保护。
-
小规格低配实例与开发机
持久小实例也保持开启。只有数据可随时重建且与生产明确隔离的临时集群，才可在书面接受风险后例外。
常见问题
- 在持久数据上关闭，并误以为 UPS 或 RAID cache 单独就足够。
- 重新开启后误以为此前不安全写入已自动持久化。
- 只测试干净关机，不测试掉电恢复。
- 混淆 pg_settings 的原始单位与配置文件可读单位。
- 只做吞吐基准，不做崩溃恢复与归档还原。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 20 ← 19 沿用 19
事实沿用 19
-
PostgreSQL 12 ← 11 仅描述更新
补充说明
The server will use the fsync() system call in several places to make sure that updates are physically written to disk. This insures that a database cluster will recover to a consistent state after an operating system or hardware crash.The server will use the fsync() system call in several places to make sure that updates are physically written to disk. This ensures that a database cluster will recover to a consistent state after an operating system or hardware crash.
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
| 版本 | 默认值 | 单位 | 上下文 | 类型 | 最小值 | 最大值 | 枚举值 |
|---|---|---|---|---|---|---|---|
| 9.0 | on |
— |
重载生效 |
布尔 |
— |
— |
— |
| 9.1 | on |
— |
重载生效 |
布尔 |
— |
— |
— |
| 9.2 | on |
— |
重载生效 |
布尔 |
— |
— |
— |
| 9.3 | on |
— |
重载生效 |
布尔 |
— |
— |
— |
| 9.4 | on |
— |
重载生效 |
布尔 |
— |
— |
— |
| 9.5 | on |
— |
重载生效 |
布尔 |
— |
— |
— |
| 9.6 | on |
— |
重载生效 |
布尔 |
— |
— |
— |
| 10 | on |
— |
重载生效 |
布尔 |
— |
— |
— |
| 11 | on |
— |
重载生效 |
布尔 |
— |
— |
— |
| 12 | on |
— |
重载生效 |
布尔 |
— |
— |
— |
| 13 | on |
— |
重载生效 |
布尔 |
— |
— |
— |
| 14 | on |
— |
重载生效 |
布尔 |
— |
— |
— |
| 15 | on |
— |
重载生效 |
布尔 |
— |
— |
— |
| 16 | on |
— |
重载生效 |
布尔 |
— |
— |
— |
| 17 | on |
— |
重载生效 |
布尔 |
— |
— |
— |
| 18 | on |
— |
重载生效 |
布尔 |
— |
— |
— |
| 19 | on |
— |
重载生效 |
布尔 |
— |
— |
— |
| 20 沿用 | on |
— |
重载生效 |
布尔 |
— |
— |
— |
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| 设置 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 数量。 | 现存 | ||||