选择 打开 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

文档 / 配置参数 / 复制

CONFIGURATION PARAMETER复制 / 备库

wal_receiver_create_temp_slot

未配置永久槽时,设置 WAL receiver 是否创建临时复制槽。

Sets whether a WAL receiver should create a temporary replication slot if no permanent slot is configured.

布尔 重载生效 引入 13 现存至 20 devel 0 次默认值变更

类型
布尔bool
上下文
重载生效改配置文件后重载(pg_ctl reload / SIGHUP)即可生效
默认值
off
引入版本
13
状态
现存

PostgreSQL 18 手册 官方文档 引入提交 3297308278

版本轨迹

相对 PostgreSQL 17 无变化。

默认值变迁

off 13 – 20

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

手册说明

PostgreSQL 18 手册 · 19.6 复制 本站手册 官方原文

指定在未配置永久复制槽时,WAL 接收进程是否应在远程实例上创建临时复制槽(使用 primary_slot_name)。 默认为"关闭"。 此参数只能在postgresql.conf文件或服务器命令行中设置。 如果在 WAL 接收进程运行时更改此参数,则该进程将发出关机的信号,并预期使用新设置重新启动。

机制详解

未配置永久槽时,设置 WAL receiver 是否创建临时复制槽。重新加载配置即可应用新值;已经开始的工作不会被追溯改变。

primary_slot_name 为空时,receiver 可为连接生命周期创建上游临时槽。它能防止连接期间删除 WAL,但断连即消失,无法保证长时间中断后的追赶。

应把 wal_receiver_create_temp_slot 与 primary_slot_name、max_replication_slots、max_slot_wal_keep_size 一起监控和变更。先在对应角色与真实负载上验证,再按其 sighup context 选择会话修改、reload 或 restart;历史默认值并不等于当前有效值。

调优建议

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

  • OLTP在线事务处理

    按主备拓扑、故障切换角色、复制槽/订阅数量与断连余量规划 wal_receiver_create_temp_slot;上线前验证主库写延迟、备库重放和磁盘保留的最坏情况。

  • OLAP分析与批处理

    读备库与逻辑订阅常有长查询或大事务,应给重放/应用留明确上界,并监控延迟、worker 饱和、槽 restart_lsn 与冲突取消。

  • 小规格低配实例与开发机

    只配置真实需要的复制能力。少量节点也应设置有界超时与槽生命周期,不要用无限保留换取表面稳定。

常见问题

  • 在错误的主库、备库、发送端或订阅端角色上修改。
  • 只看字节/时间配置,不监控真实复制延迟、槽位置与 worker 状态。
  • 故障切换后新主库缺少与旧主库一致的容量或依赖。
  • 用无限等待或无限 WAL 保留掩盖失效消费者。

演化历史

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

  1. PostgreSQL 20 ← 19 沿用 19

    事实沿用 19

  2. PostgreSQL 13 ← 12 新增此参数

    PostgreSQL 13 起可用

逐版本快照

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

版本 默认值单位上下文类型最小值最大值枚举值
13 off 重载生效 布尔
14 off 重载生效 布尔
15 off 重载生效 布尔
16 off 重载生效 布尔
17 off 重载生效 布尔
18 off 重载生效 布尔
19 off 重载生效 布尔
20 沿用 off 重载生效 布尔

参考资料

同类参数

参数 类型 上下文 默认值 版本变动 最近变更
Replication 复制 13 个
备库 13
hot_standby 布尔 重启生效 on 101 次
允许在恢复期间连接并执行查询。 现存
hot_standby_feedback 布尔 重载生效 off
允许热备库向主库反馈信息,以避免查询冲突。 现存
max_standby_archive_delay 整数 重载生效 30 s 9.11 次
设置热备处理归档 WAL 时,取消冲突查询前允许的最大延迟。 现存
max_standby_streaming_delay 整数 重载生效 30 s 9.11 次
设置热备处理流式 WAL 时,取消冲突查询前允许的最大延迟。 现存
primary_conninfo 字符串 重载生效 空字符串 131 次
设置连接发送端服务器时使用的连接字符串。 现存
primary_slot_name 字符串 重载生效 空字符串 131 次
设置连接发送端服务器时使用的复制槽名称。 现存
promote_trigger_file 字符串 重载生效 空字符串
指定一个文件,其出现会使备库结束恢复。 于 16 移除
recovery_min_apply_delay 整数 重载生效 0 ms
设置恢复期间应用变更的最小延迟。 现存
sync_replication_slots 布尔 重载生效 off
允许物理备库从主库同步逻辑故障转移复制槽。 现存
wal_receiver_create_temp_slot 布尔 重载生效 off
未配置永久槽时,设置 WAL receiver 是否创建临时复制槽。 现存
wal_receiver_status_interval 整数 重载生效 10 s
设置 WAL receiver 向发送端报告状态的最大间隔。 现存
wal_receiver_timeout 整数 重载生效 1 min 191 次
设置等待发送端数据的最长时间。 现存
wal_retrieve_retry_interval 整数 重载生效 5 s
设置 WAL 获取失败后的重试等待时间。 现存