物理恢复相关参数介绍

本节主要对恢复命令中的相关参数进行介绍。

恢复命令相关

命令

• 恢复到指定时间戳

  ALTER SYSTEM RESTORE dest_tenant_name FROM uri UNTIL TIME='timestamp' WITH 'restore_option' [WITH KEY FROM 'backup_key_path' ENCRYPTED BY 'password'] [DESCRIPTION [=] description];
  

• 恢复到指定 SCN

  ALTER SYSTEM RESTORE dest_tenant_name FROM uri UNTIL SCN=scn WITH 'restore_option' [WITH KEY FROM 'backup_key_path' ENCRYPTED BY 'password']  [DESCRIPTION [=] description];
  

• 恢复到最新位点

  ALTER SYSTEM RESTORE dest_tenant_name FROM uri WITH 'restore_option' [WITH KEY FROM 'backup_key_path' ENCRYPTED BY 'password'] [DESCRIPTION [=] description];
  

• 取消正在进行的租户恢复

  ALTER SYSTEM CANCEL RESTORE dest_tenant_name;
  

参数解释

对于指定时间戳（timestamp）的恢复方式，OceanBase 数据库将根据备份集中最新记录的时区将时间戳转换成对应的 SCN，此处的时区来源于备份租户的系统变量 system_time_zone，其默认值为 CST（即中国标准时间，+8:00），并保存在备份集的 locality_info.obbak 文件中。

例如，假设备份时租户的时区是 CDT（即美国中部夏令时区，-5:00），如果用户恢复时指定的时间戳为 2025-08-01 10:00:00，则实际恢复到的时间点是 2025-08-01 15:00:00（标准 UTC 时间）对应的 SCN 值。

更多参数的说明，参见ALTER SYSTEM - RESTORE。

timestamp 与 scn 选取约束

timestamp 与 scn 需要大于等于数据备份视图 CDB_OB_BACKUP_SET_FILES 中记录的数据备份的最小恢复位点 MIN_RESTORE_SCN，小于等于日志归档视图 CDB_OB_ARCHIVELOG 中的最大归档位点 CHECKPOINT_SCN。由于日志归档可能出现断流，因此恢复位点的选择还需要考虑日志归档的不连续区间，对于可恢复区间的选择则可能是分段的。

举例说明，假设用户的备份情况如下：

• 发起了 2 次日志归档，其中 round_id 分别为 1、2。

• 发起了 3 次数据备份，有效数据备份分别为 full_backup_set_1、 full_backup_set_2、inc_backup_set_3。

物理恢复的可恢复区间如下图所示。其中，数据备份的右边界均为 MIN_RESTORE_SCN（例如，数据备份 full_backup_set_1 的 MIN_RESTORE_SCN 对应图中的 scn 300）；日志归档的右边界均为 CHECKPOINT_SCN（例如，日志备份 round 1 的 CHECKPOINT_SCN 对应图中的 scn 500）。

由于日志归档可能发生中断，故在计算恢复区间时还需要排除中间不连续的时间段，这样就会呈现出分段的可恢复区间，即图中大括号划出的范围：[scn 300, scn 500] \∪ [scn 900, scn 1500]。

恢复性能相关

命令

ALTER SYSTEM SET ha_high_thread_score =10 TENANT = mysql;

ALTER SYSTEM SET log_restore_concurrency =0 TENANT = mysql;

参数解释

Recover 命令相关

命令

• 回放到日志到指定的时间戳，且包含该时间戳位点。

  ALTER SYSTEM RECOVER STANDBY [TENANT [=] tenant_name] UNTIL TIME='timestamp';
  

• 回放到日志到指定的 scn，且包含该 scn 位点。

  ALTER SYSTEM RECOVER STANDBY [TENANT [=] tenant_name] UNTIL SCN=scn;
  

• 无终点，持续回放归档源端日志。

  ALTER SYSTEM RECOVER STANDBY [TENANT [=] tenant_name] UNTIL UNLIMITED;
  

• 取消 Recover。

  ALTER SYSTEM RECOVER STANDBY TENANT [=] tenant_name CANCEL;
  

参数解释

ACTIVATE STANDBY 命令相关

命令

ALTER SYSTEM ACTIVATE STANDBY TENANT tenant_name;

参数解释