--- title: "backup_dest_option | OceanBase 文档中心" description: backup_dest_option backup_dest_option 用于控制备份相关的参数。 描述 属性 描述 参数类型 字符串类型 默认值 空字符串 取值范围 支持对以下参数的值进行设置，参数之间使用 & 符号连接： log_archive_checkpoint_interval recovery_wind… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 3.2.4 企业版 LTS # backup_dest_option 更新时间：2026-06-02 15:00:35 `backup_dest_option` 用于控制备份相关的参数。 ## 描述 | 属性 | 描述 | | --- | --- | | 参数类型 | 字符串类型 | | 默认值 | 空字符串 | | 取值范围 | 支持对以下参数的值进行设置，参数之间使用 `&` 符号连接： - `log_archive_checkpoint_interval` - `recovery_window` - `auto_delete_obsolete_backup` - `log_archive_piece_switch_interval` - `backup_copies` 有关各参数的详细说明，请参见下方 **使用说明** 中的信息。 | | 是否重启 OBServer 节点生效 | 否 | ## 使用说明 配置项中，各参数的详细说明如下： - `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 天后自动清理过期的备份，清理时不考虑二次备份是否已成功。 ```shell 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'; ``` ## 相关文档 该配置项中各参数的具体使用，参见 [备份前准备](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945704)。 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线