oceanbase.DBA_OB_RESTORE_PROGRESS

更新时间：2026-03-28 17:20:11

说明

该视图从 V4.0.0 版本开始引入。

功能描述

展示当前租户正在进行的恢复任务。

字段说明

字段名称	类型	是否可以为 NULL	描述
JOB_ID	bigint(20)	NO	恢复所属的 job_id, 对应一次恢复任务
RESTORE_TENANT_NAME	longtext	NO	待恢复的租户名
RESTORE_TENANT_ID	longtext	NO	待恢复的租户 ID
BACKUP_TENANT_NAME	longtext	NO	备份的源租户名
BACKUP_TENANT_ID	longtext	NO	备份的源租户 ID
BACKUP_CLUSTER_NAME	longtext	NO	备份的源集群名
BACKUP_DEST	longtext	NO	备份集路径，指用户输入的数据备份路径与日志归档路径
RESTORE_OPTION	longtext	NO	恢复选项，发起恢复时，用户指定的 `restore_option`
RESTORE_TYPE	varchar(4096)	NO	恢复类型。 `FULL`：表示全量恢复 `QUICK`：表示快速恢复说明该字段从 V4.3.5 BP1 版本开始引入。
RESTORE_SCN	bigint(20) unsigned	NO	用户指定的恢复位点
RESTORE_SCN_DISPLAY	datetime(6)	NO	用户指定的恢复位点的时间戳表示
STATUS	longtext	NO	恢复状态：系统租户的恢复任务与被恢复租户的恢复任务状态不一致。系统租户： `CREATE_TENANT`：创建租户，此阶段系统租户创建被恢复租户 `WAIT_TENANT_RESTORE_FINISH`：等待被恢复租户恢复结束 `RESTORE_SUCCESS`：恢复租户成功 `RESTORE_FAIL`：恢复租户失败被恢复租户： `RESTORE_PRE`：恢复前准备。在设置加密的情况下，设置加密信息 `RESTORE_CREATE_INIT_LS`：创建日志流 `RESTORE_WAIT_LS`：等待日志流恢复完成 `POST_CHECK`：检查租户角色，恢复成备库 `UPGRADE`：升级，如果是跨版本恢复，租户会执行升级流程 `RESTORE_SUCCESS`：恢复成功 `RESTORE_FAIL`：恢复失败
START_TIMESTAMP	datetime(6)	NO	恢复任务开始时间戳
BACKUP_SET_LIST	longtext	NO	恢复依赖的数据备份集路径列表, 备份集间以 `,` 分隔，例如：`file:///data/nfs/backup/data/backup_set_1_full,file:///data/nfs/backup/data/backup_set_2_inc`
BACKUP_PIECE_LIST	longtext	NO	恢复依赖的日志归档分片路径列表, 分片间以 `,` 分隔, 例如：`file:///data/nfs/backup/data/backup_set_1_full,file:///data/nfs/backup/data/backup_set_2_inc`
RECOVER_SCN	bigint(20) unsigned	NO	日志的恢复位点。对于系统租户，该字段的值为 `NULL` 说明对于 V4.2.1 版本，该字段从 V4.2.1 BP7 版本开始引入。对于 V4.2.x 其他版本，该字段从 V4.2.3 版本开始引入。
RECOVER_SCN_DISPLAY	datetime(6)	NO	日志的恢复位点的时间戳表示。对于系统租户，该字段的值为 `NULL` 说明对于 V4.2.1 版本，该字段从 V4.2.1 BP7 版本开始引入。对于 V4.2.x 其他版本，该字段从 V4.2.3 版本开始引入。
RECOVER_PROGRESS	decimal(6,2)	NO	日志恢复的进度，结果保留两位小数，例如：显示 `87.65` 表示当前进度为 87.65%。对于系统租户，该字段的值为 `NULL` 说明对于 V4.2.1 版本，该字段从 V4.2.1 BP7 版本开始引入。对于 V4.2.x 其他版本，该字段从 V4.2.3 版本开始引入。
TABLET_COUNT	bigint(20)	NO	待恢复的 Tablet 总数。对于系统租户，该字段的值为 `NULL` 说明对于 V4.2.1 版本，该字段从 V4.2.1 BP7 版本开始引入。对于 V4.2.x 其他版本，该字段从 V4.2.3 版本开始引入。
FINISH_TABLET_COUNT	bigint(20)	NO	已完成恢复的 Tablet 总数。对于系统租户，该字段的值为 `NULL` 说明对于 V4.2.1 版本，该字段从 V4.2.1 BP7 版本开始引入。对于 V4.2.x 其他版本，该字段从 V4.2.3 版本开始引入。
RESTORE_PROGRESS	decimal(6,2)	NO	数据恢复进度，结果保留两位小数，例如：显示 `87.65` 表示当前进度为 87.65%。对于系统租户，该字段的值为 `NULL` 说明对于 V4.2.1 版本，该字段从 V4.2.1 BP7 版本开始引入。对于 V4.2.x 其他版本，该字段从 V4.2.3 版本开始引入。
TOTAL_BYTES	bigint(20)	NO	恢复总字节数
TOTAL_BYTES_DISPLAY	varchar(27)	NO	恢复总字节数，以存储容量单位显示
FINISH_BYTES	bigint(20)	NO	完成恢复字节数
FINISH_BYTES_DISPLAY	varchar(27)	NO	完成恢复字节数，以存储容量单位显示
DESCRIPTION	longtext	NO	恢复命令里指定的 `DESCRIPTION` 信息

查询示例

用户租户查询本租户正在进行的恢复任务。

obclient [oceanbase]> SELECT * FROM oceanbase.DBA_OB_RESTORE_PROGRESS\G

查询结果如下所示：

*************************** 1. row ***************************
              JOB_ID: 3
 RESTORE_TENANT_NAME: AUX_RECOVER$1736315512813183
   RESTORE_TENANT_ID: 1012
  BACKUP_TENANT_NAME: mysql001
    BACKUP_TENANT_ID: 1002
 BACKUP_CLUSTER_NAME: test425
         BACKUP_DEST: file:///home/admin/oceanbase/arglog,file:///home/admin/oceanbase/backupdata
      RESTORE_OPTION: pool_list=rptest
        RESTORE_TYPE: QUICK
         RESTORE_SCN: 1736315345952321000
 RESTORE_SCN_DISPLAY: 2025-01-08 13:49:05.952321
              STATUS: RESTORING
     START_TIMESTAMP: 2025-01-08 13:51:52.836523
     BACKUP_SET_LIST: file:///home/admin/oceanbase/backupdata/backup_set_5_full
   BACKUP_PIECE_LIST: file:///home/admin/oceanbase/arglog/piece_d1001r1p1,file:///home/admin/oceanbase/arglog/piece_d1001r1p2
         RECOVER_SCN: 1736315345952321000
 RECOVER_SCN_DISPLAY: 2025-01-08 13:49:05.952321
    RECOVER_PROGRESS: 100.00
        TABLET_COUNT: 1258
 FINISH_TABLET_COUNT: 1257
    RESTORE_PROGRESS: 99.92
         TOTAL_BYTES: 56561873
 TOTAL_BYTES_DISPLAY: 53.94MB
        FINISH_BYTES: 0
FINISH_BYTES_DISPLAY: 0.00MB
         DESCRIPTION:
1 row in set

oceanbase.DBA_OB_RESTORE_PROGRESS

说明

功能描述

字段说明

说明

说明

说明

说明

说明

说明

说明

查询示例

相关视图或文档