PostgreSQL recovery.conf恢复配置

PostgreSQL recovery.conf恢复配置

这一章描述recovery.conf 文件中可用的设置。它们只应用于恢复期。对于你希望执行的任意后续恢复， 它们必须被重置。一旦恢复已经开始，它们就不能被更改。
recovery.conf中的设置以name = ’value’的形式指定。 每一行指定一个参数。井号（#）表示行的剩余部分是一段注释。 要在一个参数值中嵌入一个单引号，将其双写（”）。
在安装的share/目录中提供了一个例子文件， share/recovery.conf.sample。
1. 归档恢复设置
restore_command (string)用于获取 WAL 文件系列的一个已归档段的本地 shell 命令。
这个参数是归档恢复所必需的，但是对于流复制是可选的。
在该字符串中的任何 %f会被替换为从归档中检索的文件的名字，并且任何%p 会被在服务器上的复制目标路径名替换（该路径名是相对于当前工
作目录的， 即集簇的数据目录）。任何%r会被包含上一个可用重启点的文件的名字所替换。
很重要的一点是，该命令只有在成功时才返回一个零退出状态。 该命令将会被询问归档中不存在的文件名， 当这样被询问时它必须返回非零。例子：
restore_command = ’cp /mnt/server/archivedir/%f "%p"’
restore_command = ’copy "C:\\server\\archivedir\\%f" "%p"’ # Windows
archive_cleanup_command (string)
archive_cleanup_command的目的是为清理后备服务器不再需要的旧的已归档 WAL 文件提供一种机制。任何%r会被替换为包含最后一个可用重启点的文件的名称。
archive_cleanup_command = ’pg_archivecleanup /mnt/server/archivedir %r’
但是注意，如果多个后备服务器正在从同一个归档目录中恢复， 你将需要保证只有当任意服务器都不再需要 WAL 文件时才会删除它们。
recovery_end_command (string)的目的是为复制或恢复之后的清除提供一种机制。
与archive_cleanup_command中相似，任何%r 会被替换为包含最后一个可用重启点的文件的名称
2. 恢复目标设置
recovery_target = ’immediate’指定恢复应该在达到一个一致状态后尽快结束，即尽早结束。 在从一个在线备份中恢复时，这意味着备份结束的那个点。
recovery_target_name (string)指定恢复将继续进行的已命名的恢复点 （pg_create_restore_point()创建）。
recovery_target_time (timestamp)这个参数指定恢复将继续执行的时间戳。精确的停止点也受到recovery_target_inclusive的影响。
recovery_target_xid (string)指定恢复将继续执行的事务ID。
recovery_target_inclusive (boolean)指定我们是否在指定的恢复目标之后停止（true）， 或者在恢复目标之前停止（false）。
recovery_target_timeline (string)指定恢复到一个特定的时间线中。默认值是沿着基础备份建立时的当前时间线恢复。
将这个参数设置为latest会恢复到该归档中能找到的最新的时间线， 这在一个后备服务器中有用。
recovery_target_action (enum) (boolean)指定当到达恢复目标时服务器应该采取什么动作。默认值是pause， 这意味着将暂停恢复。
promote意味着将结束恢复进程并且服务器开始接受连接。 shutdown将在到达恢复目标后停止服务器。
3. 备用服务器设置
standby_mode (boolean)指定是否将PostgreSQL服务器作为一个后备服务器启动。
如果这个参数为on，当到达已归档 WAL 末尾时该服务器将不会停止恢复， 但是将通过使用restore_command获得
新的 WAL 段以及/或者通过使用 primary_conninfo设置连接到主服务器来尝试继续恢复
primary_conninfo (string)指定后备服务器用来连接主服务器的连接字符串。
如果standby_mode为off，这个设置没有效果。
primary_slot_name (string)可选的指定在通过流复制连接到主服务器时要使用的现有复制槽， 以控制上游节点上的
资源删除。 如果没有设置primary_conninfo，则这个设置无效。
trigger_file (string)指定一个触发器文件，该文件的存在会结束后备机中的恢复。即使没有设置这个值， 你
也能够使用pg_ctl promote来提升后备机。 如果standby_mode为off，则这个设置没有效果。
recovery_min_apply_delay (integer)默认情况下，后备服务器会尽快恢复来自于主服务器的 WAL 记录。