--- title: "DBA_OB_RESTORE_PROGRESS - OceanBase 数据库 V4.5.0 | OceanBase 文档中心" description: DBA_OB_RESTORE_PROGRESS 说明 该视图从 V4.0.0 版本开始引入。 功能描述 展示当前租户正在进行的恢复任务。 字段说明 字段名称 类型 是否可以为 NULL 描述 JOB_ID NUMBER(38) NO 恢复所属的 job_id, 对应一次恢复任务 RESTORE_TENANT_NAME… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.5.0 # DBA_OB_RESTORE_PROGRESS 更新时间：2026-02-24 13:11:14 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.5.0/zh-CN/700.reference/700.system-views/500.system-view-of-oracle-mode/200.dictionary-view-of-oracle-mode/14900.dba_ob_restore_progress-of-oracle-mode.md) #### 说明 该视图从 V4.0.0 版本开始引入。 ## 功能描述 展示当前租户正在进行的恢复任务。 ## 字段说明 | 字段名称 | 类型 | 是否可以为 NULL | 描述 | | --- | --- | --- | --- | | JOB_ID | NUMBER(38) | NO | 恢复所属的 job_id, 对应一次恢复任务 | | RESTORE_TENANT_NAME | VARCHAR2(4096) | NO | 待恢复的租户名 | | RESTORE_TENANT_ID | NUMBER(38) | NO | 待恢复的租户 ID | | BACKUP_TENANT_NAME | VARCHAR2(4096) | NO | 备份的源租户名 | | BACKUP_TENANT_ID | VARCHAR2(4096) | NO | 备份的源租户 ID | | BACKUP_CLUSTER_NAME | VARCHAR2(4096) | NO | 备份的源集群名 | | BACKUP_DEST | VARCHAR2(4096) | NO | 备份集路径，指用户输入的数据备份路径与日志归档路径 | | RESTORE_OPTION | VARCHAR2(4096) | NO | 恢复选项，发起恢复时，用户指定的 `restore_option` | | RESTORE_TYPE | VARCHAR2(4096) | NO | 恢复类型。 - `FULL`：表示全量恢复 - `QUICK`：表示快速恢复 #### 说明 该字段从 V4.3.5 BP1 版本开始引入。 | | RESTORE_SCN | NUMBER(38) | NO | 用户指定的恢复位点 | | RESTORE_SCN_DISPLAY | TIMESTAMP(9) | NO | 用户指定的恢复位点的时间戳表示 | | STATUS | VARCHAR2(4096) | 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 | VARCHAR2(256) | NO | 恢复任务开始时间戳 | | BACKUP_SET_LIST | VARCHAR2(4096) | NO | 恢复依赖的数据备份集路径列表, 备份集间以 `,` 分隔，例如：`file:///data/nfs/backup/data/backup_set_1_full,file:///data/nfs/backup/data/backup_set_2_inc` | | BACKUP_PIECE_LIST | VARCHAR2(4096) | NO | 恢复依赖的日志归档分片路径列表, 分片间以 `,` 分隔, 例如：`file:///data/nfs/backup/archive/2_1_2,file:///data/nfs/backup/archive/2_1_3` | | RECOVER_SCN | NUMBER(38) | NO | 日志的恢复位点。对于系统租户，该字段的值为 `NULL` #### 说明 - 对于 V4.2.1 版本，该字段从 V4.2.1 BP7 版本开始引入。 - 对于 V4.2.x 其他版本，该字段从 V4.2.3 版本开始引入。 | | RECOVER_SCN_DISPLAY | TIMESTAMP(9) | NO | 日志的恢复位点的时间戳表示。对于系统租户，该字段的值为 `NULL` #### 说明 - 对于 V4.2.1 版本，该字段从 V4.2.1 BP7 版本开始引入。 - 对于 V4.2.x 其他版本，该字段从 V4.2.3 版本开始引入。 | | RECOVER_PROGRESS | NUMBER | NO | 日志恢复的进度，结果保留两位小数，例如：显示 `87.65` 表示当前进度为 87.65%。对于系统租户，该字段的值为 `NULL` #### 说明 - 对于 V4.2.1 版本，该字段从 V4.2.1 BP7 版本开始引入。 - 对于 V4.2.x 其他版本，该字段从 V4.2.3 版本开始引入。 | | TABLET_COUNT | NUMBER(38) | NO | 待恢复的 Tablet 总数。对于系统租户，该字段的值为 `NULL` #### 说明 - 对于 V4.2.1 版本，该字段从 V4.2.1 BP7 版本开始引入。 - 对于 V4.2.x 其他版本，该字段从 V4.2.3 版本开始引入。 | | FINISH_TABLET_COUNT | NUMBER(38) | NO | 已完成恢复的 Tablet 总数。对于系统租户，该字段的值为 `NULL` #### 说明 - 对于 V4.2.1 版本，该字段从 V4.2.1 BP7 版本开始引入。 - 对于 V4.2.x 其他版本，该字段从 V4.2.3 版本开始引入。 | | RESTORE_PROGRESS | NUMBER | NO | 数据恢复进度，结果保留两位小数，例如：显示 `87.65` 表示当前进度为 87.65%。对于系统租户，该字段的值为 `NULL` #### 说明 - 对于 V4.2.1 版本，该字段从 V4.2.1 BP7 版本开始引入。 - 对于 V4.2.x 其他版本，该字段从 V4.2.3 版本开始引入。 | | TOTAL_BYTES | NUMBER(38) | NO | 恢复总字节数 | | TOTAL_BYTES_DISPLAY | VARCHAR2(42) | NO | 恢复总字节数，以存储容量单位展示 | | FINISH_BYTES | NUMBER(38) | NO | 完成恢复字节数 | | FINISH_BYTES_DISPLAY | VARCHAR2(42) | NO | 恢复总字节数，以存储容量单位展示 | | DESCRIPTION | VARCHAR2(4096) | NO | 恢复命令里指定的 `DESCRIPTION` 信息 | ## 查询示例 用户租户查询本租户正在进行的恢复任务。 ```shell obclient [SYS]> SELECT * FROM SYS.DBA_OB_RESTORE_PROGRESS\G ``` 查询结果如下所示： ```shell *************************** 1. row *************************** JOB_ID: 3 RESTORE_TENANT_NAME: AUX_RECOVER$1736315512813184 RESTORE_TENANT_ID: 1012 BACKUP_TENANT_NAME: oracle001 BACKUP_TENANT_ID: 1004 BACKUP_CLUSTER_NAME: test425 BACKUP_DEST: file:///home/admin/oceanbase/arglogorc,file:///home/admin/oceanbase/backupdataorc 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/backupdataorc/backup_set_5_full BACKUP_PIECE_LIST: file:///home/admin/oceanbase/arglogorc/piece_d1001r1p1,file:///home/admin/oceanbase/arglogorc/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 ``` ## 相关文档 - 查看所有租户物理恢复任务当前的执行进度：[CDB_OB_RESTORE_PROGRESS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477691) - 查看所有租户已完成的租户级恢复任务：[CDB_OB_RESTORE_HISTORY](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477711) - 查看物理恢复进度的详细操作及说明，参见 [查看物理恢复进度](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004475979)。 上一篇 下一篇 ![有帮助](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) 咨询热线