暂无图片
暂无图片
3
暂无图片
暂无图片
暂无图片

PostgreSQL12恢复配置总结

原创 贺晓群 2020-05-19
7311

PostgreSQL V12中没有了recovery.conf
从向后兼容的观点来看,PostgreSQL v12中最大的变化是recovery.conf文件中的参数放到了postgresql.conf配置文件中。

本文主要介绍他们的变化以及如何适应。

放弃recovery.conf
在PG12以前,如果数据目录存在recovery.conf文件,当PG实例启动时将进入恢复模式(recovery或standby),该文件包含了用于配置恢复的所有参数,例如:
standby_mode:确定这是正常的归档恢复还是standby模式
restore_command:此命令恢复已归档的WAL段
recovery_target*:此参数确定要恢复到的点
primary_conninfo:如何连接到流复制主服务器
长期以来,recovery.conf一直被认为是一个缺陷,因为配置参数分布在多个不同的文件中是不合理的,另外还不能使用ALTER SYSTEM命令对参数进行修改。

从v12开始,针对此问题进行了改进,把recovery.conf中的参数合到了postgresql.conf配置文件中,但在非恢复模式这些参数将被忽略。

这个修改对PG新手来说更加的自然,但是对PG老油条估计得适应以下方面:

一、如何告诉PostgreSQL进入恢复模式?
在PG12以前,recovery.conf该文件的存在即触发恢复模式。
从PG12开始,由于该文件不存在,由下面两个新文件进行替换:
recovery.signal:告诉PostgreSQL进入正常的归档恢复
standby.signal:告诉PostgreSQL进入standby模式
如果两个文件都存在,则standby.signal优先。
这些文件不需要包含任何数据,存在的任何数据将被忽略,只要存在就有意义。如果提升了备用数据库,则将完全删除standby.signal(而不是像recovery.conf那样重命名,变成recovery.done)。同样,如果正在进行时间点恢复,则一旦达到恢复目标,recovery.signal将被删除(除非将recovery_target_action设置为shutdown)。请注意:与recovery.conf一样,目录中缺少这些文件将导致PostgreSQL实例立即作为主实例启动,无论postgresql.conf是否包含复制配置。

二、恢复参数有哪些变化?
先前存储在recovery.conf中的恢复配置参数大部分没有变化,但以下情况除外。
standby_mode:先前的参数standby_mode已被删除,并已由上述standby.signal和recovery.signal文件代替。
trigger_file:参数trigger_file已重命名为promote_trigger_file(注意:可用版本为12-15,16版本已经删除此参数,可以使用pg_ctl promote 或 pg_promote() )。
在PG12以前,要将更改应用于recovery.conf,需要完全重启服务器。尽管这对PG12及以上版本也是正确的,但是现在可以通过SIGHUP更改以下恢复配置项:
archive_cleanup_command
promote_trigger_file
recovery_end_command
recovery_min_apply_delay
以下查询列出了所有以前的recovery.conf参数:

SELECT name, setting, category, short_desc, CONTEXT, pending_restart FROM pg_catalog.pg_settings WHERE category IN('Write-Ahead Log / Archive Recovery', 'Write-Ahead Log / Recovery Target') OR name IN ('primary_conninfo', 'primary_slot_name', 'promote_trigger_file', 'recovery_min_apply_delay') ORDER BY category, name;

三、恢复完成后参数会发生什么变化?
在PG12以前,恢复完成,recovery.conf被重命名为recovery.done,这有效地删除了恢复参数。
从PG12开始,恢复完成后将删除recovery.signal或standby.signal文件,但其中的参数postgresql.conf仍然保留。只要PostgreSQL不在恢复中,它们就会被忽略,但是最好用“#”注释禁用它们。这样可以避免以后出现令人讨厌的意外情况,例如在创建备用服务器时。
如果需要设置这些恢复参数建议使用ALTER SYSTEM,如果需要重置它们建议使用ALTER SYSTEM RESET。

四、在使用pg_basebackup工具时,如果使用了"–write-recovery-conf"选项会怎样?
在PG12中,选项仍然存在,但是它不再是创建recovery.conf文件,而是添加恢复配置参数。
与其将参数添加到postgresql.conf,不如和ALTER SYSTEM一样将其添加到postgresql.auto.conf。

五、如果我在PG12中使用recovery.conf进行恢复会发生什么?
PostgreSQL 12数据目录中的存在recovery.conf,将导致PostgreSQL实例拒绝启动,并出现以下错误:
FATAL: using recovery command file “recovery.conf” is not supported

六、如何调整我的备份脚本?
备份不受更改的影响。因此,您的备份脚本无需修改。
执行归档恢复或设置备用服务器的脚本必须进行修改。主要困难将是添加必要的恢复参数。
我的建议是将参数添加到postgresql.auto.conf,因为如前所述,该文件是为自动编辑而制作的。
这是bash要添加的一些示例代码recovery_target_time:

sed -i "/^recovery_target/d" $PGDATA/postgresql.auto.conf sed -i "$ a recovery_target_time = '2020-05-19 13:00:00'" $PGDATA/postgresql.auto.conf

首先删除所有以"recovery_target"开头的选项,然后添加参数。
启动服务器之前,请不要忘记执行以下操作:
touch $PGDATA/recovery.signal
我建议您在恢复完成后再次删除恢复参数。

七、我正在使用一些第三方备份软件-我该怎么办?
到现在为止,任何值得其使用的专用PostgreSQL备份软件都应该已经适应了这些更改,升级到当前版本。
PostgreSQL v12对最广泛使用的程序的支持:
pgBackRest:支持2.18版以上的v12
pg_probackup:支持从2.2.5版本开始的v12
Barman:支持2.9版以上的v12

八、有哪些需要注意的事项?
从表面上看,与管理其它参数一样,但是在行为上发生了一些潜在的改变。

  • ALTER SYSTEM设置始终优先处理
    如果恢复设置存储在postgresql.conf中,并且有人通过执行ALTER SYSTEM来更改设置,则ALTER SYSTEM设置的参数(并写入postgresql.auto.conf)将始终优先。如果随后尝试更新postgresql.conf中的复制设置,并且未考虑设置也可能存在于postgresql.auto.conf中的可能性,则可能引起混乱,这也是上面再三建议写入postgresql.auto.conf文件
  • 恢复配置设置甚至可以在主服务器上出现
    任何已配置的恢复配置设置(例如primary_conninfo)都将由PostgreSQL读取,并且可以正常显示,但是它们的存在并不表示该节点是否为备节点。
  • 没有固定的位置可以配置恢复参数
    众所周知recovery.conf只有一个文件,可以写入恢复设置,这可以确保在服务器启动时可以读取它们。但从PG12开始,恢复设置可以位于具有常规PostgreSQL配置文件的任何位置。由于最后读取的配置参数具有优先权,因此有可能会忽略前面的参数,并且使用错误的设置会错误地启动PostgreSQL。编写恢复配置设置(例如pg_basebackup或repmgr)并且需要确保最后读取这些设置,因此需要将它们添加到postgresql.auto.conf文件中。
  • 信号文件混乱的风险
    由于已将standby_mode参数替换为创建两个信号文件之一,并且由于standby.signal的优先级高于recovery.signal,因此存在需要恢复时,设置了recovery.signal,但同时存在standby.signal文件导致恢复错误。
  • 只能指定recovery_target类中的一个参数
    如果PostgreSQL配置中存在多个recovery_target\recovery_target_lsn\recovery_target_name\recovery_target_time\recovery_target_xid之一,则实例将发出致命错误在启动时:
FATAL: multiple recovery targets specified DETAIL: At most one of recovery_target, recovery_target_lsn, recovery_target_name, recovery_target_time, recovery_target_xid may be set.

在PG12以前,使用这些参数中的最后一个,而忽略了之前的参数。

最后修改时间:2023-12-11 09:28:51
「喜欢这篇文章,您的关注和赞赏是给作者最好的鼓励」
关注作者
【版权声明】本文为墨天轮用户原创内容,转载时必须标注文章的来源(墨天轮),文章链接,文章作者等基本信息,否则作者和墨天轮有权追究责任。如果您发现墨天轮中有涉嫌抄袭或者侵权的内容,欢迎发送邮件至:contact@modb.pro进行举报,并提供相关证据,一经查实,墨天轮将立刻删除相关内容。

评论