synchronous_standby_names
Fact — 官方简述译文：设置同步备库数量及候选备库名称列表。
身份
生命周期
| Fact | 值 |
|---|---|
| 首次观测 | PG9.1 |
| 在档版本 | PG9.1–19 Beta 3 |
| 移除版本 | 否 |
| 引入提交 | a8a8a3e09652 — Efficient transaction-controlled synchronous replication. If a standby is broadcasting reply messages and we have named one or more standbys in synchronous_standby_names then allow users who set synchronous_replication to wait for commit, which then provides strict data integrity guarantees. Design avoids sending and receiving transaction state information so minimises bookkeeping overheads. We synchronize with the highest priority standby that is connected and ready to synchronize. Other standbys can be defined to takeover in case of standby failure. |
| 提交日期 | 2011-03-06 |
| Discussion | — |
默认值变迁
| 版本 | 原始 boot_val |
单位 | 人类可读值 |
|---|---|---|---|
| PG9.1–19 Beta 3 | "" |
— | empty string |
机制详解
设置同步备库数量及候选备库名称列表。重新加载配置即可应用新值；已经开始的工作不会被追溯改变。
它按备库 application_name 解析优先级 FIRST 或仲裁 ANY 语法，只定义可用确认者；每个事务等待什么由 synchronous_commit 决定，重复名称或通配符可能使实际选择出乎预期。
应把 synchronous_standby_names 与 synchronous_commit、wal_sender_timeout、max_wal_senders 一起监控和变更。先在对应角色与真实负载上验证，再按其 sighup context 选择会话修改、reload 或 restart；历史默认值并不等于当前有效值。
调优建议
Advice。 以下建议是工作负载起点，必须用真实测量验证。
| 场景 | 建议 |
|---|---|
| OLTP | 按主备拓扑、故障切换角色、复制槽/订阅数量与断连余量规划 synchronous_standby_names；上线前验证主库写延迟、备库重放和磁盘保留的最坏情况。 |
| OLAP | 读备库与逻辑订阅常有长查询或大事务，应给重放/应用留明确上界，并监控延迟、worker 饱和、槽 restart_lsn 与冲突取消。 |
| 小规格 | 只配置真实需要的复制能力。少量节点也应设置有界超时与槽生命周期，不要用无限保留换取表面稳定。 |
Pigsty 取值
以下值来自固定 8 核、32 GiB、100 GiB SSD 夹具，并按 PG19 Beta 3 渲染当前 Pigsty 模板；这不表示 Pigsty 当前支持该历史或测试版本。
| 模板 | 有效值 | 与上游 boot 比较 | 源表达式 |
|---|---|---|---|
| OLTP | 未修改 | — | — |
| OLAP | 未修改 | — | — |
| CRIT | 未修改 | — | — |
| TINY | 未修改 | — | — |
Advice — 待人工复核。 当前 Pigsty 模板投影事实：OLTP: PG9.1–19 Beta 3 未修改；OLAP: PG9.1–19 Beta 3 未修改；CRIT: PG9.1–19 Beta 3 未修改；TINY: PG9.1–19 Beta 3 未修改。 未发现覆盖值，因此不推断 Pigsty 专属理由。
常见坑
- 误以为只配置列表就能让每个事务同步。
- 重复 application_name 导致优先级选择不确定。
- ANY/FIRST 数量在计划维护期间无法满足。
- 在错误的主库、备库、发送端或订阅端角色上修改。
- 只看字节/时间配置，不监控真实复制延迟、槽位置与 worker 状态。
关联参数
synchronous_commit · wal_sender_timeout · max_wal_senders · application_name · synchronized_standby_slots · vacuum_defer_cleanup_age