backup_dest_option

backup_dest_option 用于控制备份相关的参数。

描述

使用说明

配置项中，各参数的详细说明如下：

• log_archive_checkpoint_interval：用于控制冷分区 Checkpoint 任务的生成间隔，以推进其归档进度。默认值为 120s，取值范围为 [5s, 1h]。与配置项 log_archive_checkpoint_interval 的功能相同。

  说明

  在日志备份过程中，有写入的分区由 Clog 被归档来推进其归档进度，由于冷分区没有日志写入，故需要引入 Checkpoint 任务来推进冷分区的归档进度。

  在配置该参数时：

  • 如果仅设置配置项 backup_dest_option，则以 backup_dest_option 配置的值为准。

  • 如果仅设置配置项 log_archive_checkpoint_interval，则以 log_archive_checkpoint_interval 配置的值为准。

  • 如果未设置配置项 backup_dest_option 和 log_archive_checkpoint_interval，则使用默认值 120s。

  • 如果已设置配置项 backup_dest_option 和 log_archive_checkpoint_interval，则以 backup_dest_option 配置的值为准。建议使用配置项 backup_dest_option 来设置冷分区 Checkpoint 任务的生成间隔。

• recovery_window：用于控制备份数据可恢复的时间窗口，以及作为判断备份数据是否过期的依据。默认值为 0，表示备份数据不过期，取值范围为 [0, +∞)。该参数的取值单位为 d（天），填写值时，需带上单位才能生效。与配置项 backup_recovery_window 的功能相同。

  例如，设置 recovery_window='7d' 表示从当前时间往前推，7 天内的数据保证可恢复，且与这 7 天数据恢复无关的备份数据将被视为过期的数据。

  对于自动清理场景，备份的数据过期后，系统会按照一定的规则自动清理过期的数据；对于手动清理的场景，备份的数据过期后，管理员可以手动清理过期的备份数据。

  在配置该参数时：

  • 如果仅设置配置项 backup_dest_option，则以 backup_dest_option 配置的值为准。

  • 如果仅设置配置项 backup_recovery_window，则以 backup_recovery_window 配置的值为准。

  • 如果未设置配置项 backup_dest_option 和 backup_recovery_window，则使用默认值 0，表示备份数据不过期。

  • 如果已设置配置项 backup_dest_option 和 backup_recovery_window，则以 backup_dest_option 配置的值为准。建议使用配置项 backup_dest_option 来设置备份数据可恢复的时间窗口。

• auto_delete_obsolete_backup：用于控制是否启动自动清理功能，与配置项 auto_delete_expired_backup 的功能相同。取值如下：

  • true：系统会自动清理过期的的备份数据。
  • false：系统不会自动清理过期的备份数据。默认为 false。

  在配置该参数时：

  • 如果仅设置配置项 backup_dest_option，则以 backup_dest_option 配置的值为准。

  • 如果仅设置配置项 auto_delete_expired_backup，则以 auto_delete_expired_backup 配置的值为准。

  • 如果配置项 backup_dest_option 和 auto_delete_expired_backup 均未设置，则系统会使用默认值 false，表示不自动清理过期的备份数据。

  • 如果配置项 backup_dest_option 和 auto_delete_expired_backup 均已设置，则以 backup_dest_option 配置的值为准。建议使用配置项 backup_dest_option 来设置。

• log_archive_piece_switch_interval：用于控制自动按照时间段来切日志文件的目录。默认值为 0，表示不切分 Piece, 有效范围为 [1d, 7d]。

  如果需要开启切分 Piece 的备份，则需要配置此参数。

• backup_copies：用于指定一个备份集的冗余度。默认值为 0，表示在清理备份时，系统不会考虑备份备份数据（二次备份）是否已成功。如果设置了 backup_backup_dest，建议该参数设置为 2，其有效范围为 [0,8]。

  如果 backup_copies 设置为小于 2，则在清理备份时，系统不会考虑备份备份数据（二次备份）是否已成功；如果 backup_copies 设置为 2，则仅当成功将备份数据备份到 backup_backup_dest 后才会自动清理 backup_dest 下的备份。如果未设置备份的备份（二次备份），建议此参数使用默认值。

配置示例

配置冷分区 Checkpoint 任务的生成间隔为 2 分钟，开启切 Piece 模式且每天切分 1 个日志 Piece，7 天后自动清理过期的备份，清理时不考虑二次备份是否已成功。

obclient> ALTER SYSTEM SET backup_dest_option='log_archive_checkpoint_interval=2m&recovery_window=7d&auto_delete_obsolete_backup=true&log_archive_piece_switch_interval=1d&backup_copies=0';

相关文档

该配置项中各参数的具体使用，参见 备份前准备。