复制 | GUC 大典

hot_standby

hot_standby：允许在恢复期间连接并执行查询。实测在档范围为 PG9.0–19 Beta 3；最后在档的 PG19 Beta 3 启动默认值为 on，context 为 postmaster。这是测试版快照事实，PostgreSQL 19 正式发布前仍可能变化。

hot_standby_feedback

hot_standby_feedback：允许热备库向主库反馈信息，以避免查询冲突。实测在档范围为 PG9.1–19 Beta 3；最后在档的 PG19 Beta 3 启动默认值为 off，context 为 sighup。这是测试版快照事实，PostgreSQL 19 正式发布前仍可能变化。

idle_replication_slot_timeout

idle_replication_slot_timeout：设置复制槽保持空闲多久后失效。实测在档范围为 PG18–19 Beta 3；最后在档的 PG19 Beta 3 启动默认值为 0 s，context 为 sighup。这是测试版快照事实，PostgreSQL 19 正式发布前仍可能变化。

max_active_replication_origins

max_active_replication_origins：设置可同时活动的复制源最大数量。实测在档范围为 PG18–19 Beta 3；最后在档的 PG19 Beta 3 启动默认值为 10，context 为 postmaster。这是测试版快照事实，PostgreSQL 19 正式发布前仍可能变化。

max_logical_replication_workers

max_logical_replication_workers：设置逻辑复制 worker 进程的最大数量。实测在档范围为 PG10–19 Beta 3；最后在档的 PG19 Beta 3 启动默认值为 4，context 为 postmaster。这是测试版快照事实，PostgreSQL 19 正式发布前仍可能变化。

max_parallel_apply_workers_per_subscription

max_parallel_apply_workers_per_subscription：设置每个订阅的并行应用 worker 最大数量。它是 PG16–18 的 sighup 参数；最新实测启动默认值为 2。

max_repack_replication_slots

max_repack_replication_slots：设置 REPACK 命令可使用的最大复制槽数量。实测在档范围为 PG19 Beta 3；最后在档的 PG19 Beta 3 启动默认值为 5，context 为 postmaster。这是测试版快照事实，PostgreSQL 19 正式发布前仍可能变化。

max_replication_slots

max_replication_slots：设置可同时定义的复制槽最大数量。实测在档范围为 PG9.4–19 Beta 3；最后在档的 PG19 Beta 3 启动默认值为 10，context 为 postmaster。这是测试版快照事实，PostgreSQL 19 正式发布前仍可能变化。

max_slot_wal_keep_size

在检查点时限制复制槽可保留 WAL 大小的可重载参数。本目录从 PG13 起收录，默认 -1（无限制）；Pigsty 使用有限的磁盘比例上限。

max_standby_archive_delay

max_standby_archive_delay：设置热备处理归档 WAL 时，取消冲突查询前允许的最大延迟。实测在档范围为 PG9.0–19 Beta 3；最后在档的 PG19 Beta 3 启动默认值为 30 s，context 为 sighup。这是测试版快照事实，PostgreSQL 19 正式发布前仍可能变化。

max_standby_streaming_delay

max_standby_streaming_delay：设置热备处理流式 WAL 时，取消冲突查询前允许的最大延迟。实测在档范围为 PG9.0–19 Beta 3；最后在档的 PG19 Beta 3 启动默认值为 30 s，context 为 sighup。这是测试版快照事实，PostgreSQL 19 正式发布前仍可能变化。

max_sync_workers_per_subscription

max_sync_workers_per_subscription：设置每个订阅的表同步 worker 最大数量。实测在档范围为 PG10–19 Beta 3；最后在档的 PG19 Beta 3 启动默认值为 2，context 为 sighup。这是测试版快照事实，PostgreSQL 19 正式发布前仍可能变化。

max_wal_senders

max_wal_senders：设置可同时运行的 WAL sender 进程最大数量。实测在档范围为 PG9.0–19 Beta 3；最后在档的 PG19 Beta 3 启动默认值为 10，context 为 postmaster。这是测试版快照事实，PostgreSQL 19 正式发布前仍可能变化。

output_plugin_libraries

output_plugin_libraries：列出可作为逻辑解码输出插件指定的库。它是 PG14–18 的 superuser 参数；最新实测启动默认值为 pgoutput, test_decoding。

primary_conninfo

primary_conninfo：设置连接发送端服务器时使用的连接字符串。它是 PG12–18 的 sighup 参数；最新实测启动默认值为 empty。

primary_slot_name

primary_slot_name：设置连接发送端服务器时使用的复制槽名称。它是 PG12–18 的 sighup 参数；最新实测启动默认值为 empty。

promote_trigger_file

promote_trigger_file：指定一个文件，其出现会使备库结束恢复。它存在于 PG12–15 实测矩阵，并在 PG16 移除。PostgreSQL 16 移除了触发文件机制；应由 HA 控制器调用 pg_ctl promote 或 pg_promote()。

recovery_min_apply_delay

recovery_min_apply_delay：设置恢复期间应用变更的最小延迟。它是 PG12–18 的 sighup 参数；最新实测启动默认值为 0 ms。

replication_timeout

replication_timeout：设置等待 WAL 复制活动的最长时间。实测在档范围为 PG9.1–9.2；最后在档的 PG9.2 启动默认值为 1 min，context 为 sighup。它在 PG9.3 被移除。

sync_replication_slots

sync_replication_slots：允许物理备库从主库同步逻辑故障转移复制槽。它是 PG17–18 的 sighup 参数；最新实测启动默认值为 off。

synchronized_standby_slots

synchronized_standby_slots：列出逻辑 WAL sender 必须等待的流复制备库槽。它是 PG17–18 的 sighup 参数；最新实测启动默认值为 empty。

synchronous_standby_names

synchronous_standby_names：设置同步备库数量及候选备库名称列表。实测在档范围为 PG9.1–19 Beta 3；最后在档的 PG19 Beta 3 启动默认值为 empty string，context 为 sighup。这是测试版快照事实，PostgreSQL 19 正式发布前仍可能变化。

track_commit_timestamp

track_commit_timestamp：记录事务提交时间。实测在档范围为 PG9.5–19 Beta 3；最后在档的 PG19 Beta 3 启动默认值为 off，context 为 postmaster。这是测试版快照事实，PostgreSQL 19 正式发布前仍可能变化。

vacuum_defer_cleanup_age

vacuum_defer_cleanup_age：设置 VACUUM 与 HOT 清理要延后多少个事务。实测在档范围为 PG9.0–15；最后在档的 PG15 启动默认值为 0，context 为 sighup。它在 PG16 被移除。

wal_keep_segments

wal_keep_segments：设置为备库保留的 WAL 文件数量。实测在档范围为 PG9.0–12；最后在档的 PG12 启动默认值为 0，context 为 sighup。它在 PG13 被移除。

wal_keep_size

为可能落后的流复制备库额外保留旧 WAL 的可重载最小值。本目录从 PG13 起收录该参数，默认 0 MB，Pigsty 四个模板均未修改。

wal_receiver_create_temp_slot

wal_receiver_create_temp_slot：未配置永久槽时，设置 WAL receiver 是否创建临时复制槽。它是 PG13–18 的 sighup 参数；最新实测启动默认值为 off。

wal_receiver_status_interval

wal_receiver_status_interval：设置 WAL receiver 向发送端报告状态的最大间隔。实测在档范围为 PG9.1–19 Beta 3；最后在档的 PG19 Beta 3 启动默认值为 10 s，context 为 sighup。这是测试版快照事实，PostgreSQL 19 正式发布前仍可能变化。

wal_receiver_timeout

wal_receiver_timeout：设置等待发送端数据的最长时间。实测在档范围为 PG9.3–19 Beta 3；最后在档的 PG19 Beta 3 启动默认值为 1 min，context 为 user。这是测试版快照事实，PostgreSQL 19 正式发布前仍可能变化。

wal_retrieve_retry_interval

wal_retrieve_retry_interval：设置 WAL 获取失败后的重试等待时间。实测在档范围为 PG9.5–19 Beta 3；最后在档的 PG19 Beta 3 启动默认值为 5 s，context 为 sighup。这是测试版快照事实，PostgreSQL 19 正式发布前仍可能变化。

wal_sender_delay

wal_sender_delay：设置 WAL sender 两次复制动作之间的休眠时间。实测在档范围为 PG9.0–9.1；最后在档的 PG9.1 启动默认值为 1 s，context 为 sighup。它在 PG9.2 被移除。

wal_sender_shutdown_timeout

wal_sender_shutdown_timeout：设置关机时等待 WAL 全部复制到接收端的最长时间。实测在档范围为 PG19 Beta 3；最后在档的 PG19 Beta 3 启动默认值为 -1 ms，context 为 user。这是测试版快照事实，PostgreSQL 19 正式发布前仍可能变化。

wal_sender_timeout

wal_sender_timeout：设置等待 WAL 复制活动的最长时间。实测在档范围为 PG9.3–19 Beta 3；最后在档的 PG19 Beta 3 启动默认值为 1 min，context 为 user。这是测试版快照事实，PostgreSQL 19 正式发布前仍可能变化。