首批通过分布式安全可靠测评,为关键业务系统打造
物理恢复相关参数介绍
更新时间:2026-06-26 09:52:50
本节主要对恢复命令中的相关参数进行介绍。
恢复命令相关
命令
恢复到指定时间戳
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;
参数解释
| 参数 | 描述 |
|---|---|
| dest_tenant_name | 指恢复的新租户的名称。 |
| uri | 指备份时设置的数据备份路径 backup_data_dest 与日志归档路径 log_archive_dest,该值至少包含一条数据备份路径和一条日志归档路径,路径间用 , 分隔。 |
| timestamp | 指恢复指定时间戳,恢复到该时间点为止,且包括该 timestamp 位点,指定 timestamp 必须以 = 连接。timestamp 仅支持 YYYY-MM-DD HH24:MI:SS.FF 格式,并且小数部分(FF)支持 0~6 位小数,可以精确到微秒。 |
| scn | 指恢复指定的 SCN,恢复到该 SCN 位点为止,且包括该 scn 位点,指定 scn 须以 = 连接。 |
| restore_option | 支持指定 pool_list、locality、primary_zone、concurrency,不同参数之间通过 & 分隔。在指定 locality 和 primary_zone 时,建议尽量与源租户保持同构。如果不同构,待租户恢复后激活为主租户可能会产生负载均衡操作,影响性能。
注意OceanBase 集中式数据库中不需要指定 |
| WITH KEY FROM 'backup_key_path' ENCRYPTED BY 'password' | 指定加密租户的秘钥备份信息。仅当源租户配置了透明加密,才需要在恢复时指定秘钥备份相关的信息。其中:
|
| description | 为可选项,指用户指定的描述信息。 |
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;
参数解释
| 参数 | 描述 |
|---|---|
| ha_high_thread_score | 设置恢复任务队列使用的线程数。 |
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;
参数解释
| 参数 | 描述 |
|---|---|
| tenant_name | 租户名 |
| timestamp | 指恢复指定时间戳,恢复到该时间点为止,且包括该 timestamp 位点,指定 timestamp 必须以 = 连接。timestamp 仅支持 YYYY-MM-DD HH24:MI:SS.FF 格式,并且小数部分(FF)支持 0~6 位小数,可以精确到微秒。 |
| scn | 指恢复指定的 SCN,恢复到该 SCN 位点为止,且包括该 scn 位点,指定 scn 须以 = 连接。 |
| UNLIMITED | 无终点恢复,持续回放归档源端日志。 |
ACTIVATE STANDBY 命令相关
命令
ALTER SYSTEM ACTIVATE STANDBY TENANT tenant_name;
参数解释
| 参数 | 描述 |
|---|---|
| tenant_name | 恢复成功的备租户名。当前每条命令仅支持切换一个租户。 |