归档

archive_mode

参数说明: 表示是否进行归档操作。

该参数属于SIGHUP类型参数，请参考表GUC参数分类中对应设置方法进行设置。

须知：

当wal_level设置成minimal时，archive_mode参数无法使用。

取值范围: 布尔型

• on表示进行归档。
• off表示不进行归档。

默认值: off

archive_command

参数说明: 由管理员设置的用于归档WAL日志的命令，建议归档路径为绝对路径。

该参数属于SIGHUP类型参数，请参考表GUC参数分类中对应设置方法进行设置。

须知：

• 当archive_dest和archive_command同时配置时，WAL日志优先保存到archive_dest所设置的目录中，archive_command配置的命令不生效。

• 字符串中任何%p都被要归档的文件的绝对路径代替，而任何%f都只被该文件名代替（相对路径都相对于数据目录的）。如果需要在命令里嵌入%字符就必须双写%。

• 这个命令当且仅当成功的时候才返回零。示例如下:

  archive_command = 'cp --remove-destination %p /mnt/server/archivedir/%f'

• --remove-destination选项作用为：拷贝前如果目标文件已存在，会先删除已存在的目标文件，然后执行拷贝操作。

• 如果归档命令有多条，则需将其写入SHELL脚本文件中，然后将archive_command配置为执行该脚本的命令。示例如下：

  --假设多条命令如下。
  test ! -f dir/%f && cp %p dir/%f
  --则test.sh脚本内容如下。
  test ! -f dir/$2 && cp $1 dir/$2
  --归档命令如下。
  archive_command='sh dir/test.sh %p %f'

取值范围: 字符串

默认值: (disabled)

archive_dest

参数说明: 由管理员设置的用于归档WAL日志的目录，建议归档路径为绝对路径。

该参数属于SIGHUP类型参数，请参考表GUC参数分类中对应设置方法进行设置。

须知：

• 当archive_dest和archive_command同时配置时，WAL日志优先保存到archive_dest所设置的目录中，archive_command配置的命令不生效。

• 字符串中如果是相对路径为相对于数据目录的。示例如下。

  archive_dest = '/mnt/server/archivedir/'

取值范围: 字符串

默认值: 空字符串

archive_timeout

参数说明: 表示归档周期。

archive_timeout适用于未使用主备流式复制或者需要对WAL日志进行归档的场景，默认情况下，WAL达到一定大小会进行文件切换，归档此时能将WAL文件复制过去。系统空闲时可能导致部分WAL日志一直留在内存中，无法及时被归档。archive_timeout设置为大于0后，系统会在超过设定值时强制将内存中的WAL内容刷到磁盘上，以实现WAL日志及时归档。

该参数属于SIGHUP类型参数，请参考表GUC参数分类中对应设置方法进行设置。

须知：

• 超过该参数设定的时间时强制切换WAL段。
• 由于强制切换而提早关闭的归档文件仍然与完整的归档文件长度相同。因此，将archive_timeout设为很小的值将导致占用巨大的归档存储空间，建议将archive_timeout设置为60秒。

取值范围: 整型，0 ~ INT_MAX，单位为秒。其中0表示禁用该功能。

默认值: 0

archive_interval

参数说明：表示归档间隔时间。在分布式备机归档和OBS归档场景下，每隔一个归档间隔时间会发送一个请求给备机要求其对所有的WAL进行归档，这种情况下备机可能会对某一个xlog数据多次重复归档，避免在archive_timeout时间段内存在某些文件丢失而没来得及归档造成数据丢失的情况。此参数仅用于分布式或备机归档，启用时需额外创建归档槽，目前不投入使用。

该参数属于SIGHUP类型参数，请参考GUC参数分类中对应设置方法进行设置。

须知：

• 超过该参数设定的时间时强制归档日志文件。
• 由于归档有IO操作，不可过于频繁的归档，也不能设置较大影响PITR的RPO建议使用默认值。

取值范围：整型，1 ~ 1000‬，单位为秒。

默认值：1

time_to_target_rpo

参数说明： 双数据库实例异地灾备模式下，设置主数据库实例发生异常发生时到已归档到OBS的恢复点所允许的time_to_target_rpo秒。

该参数属于SIGHUP类型参数，请参考GUC参数分类中对应设置方法进行设置。

取值范围：整型，0~3600（秒）

双数据库实例异地灾备模式下，主数据库实例日志将被归档到OBS。

0是指不开启日志流控，1~3600是指设置主数据库实例发生异常发生时到已归档到OBS的恢复点所允许的time_to_target_rpo秒，保证主数据库实例因灾难崩溃时，最多可能丢失的数据的时长在允许范围内。

time_to_target_rpo设置时间过小会影响主机的性能，设置过大会失去流控效果。

默认值：0