首批通过分布式安全可靠测评，为关键业务系统打造
oceanbase.CDB_OB_RESTORE_PROGRESS
更新时间：2026-04-06 20:55:00
编辑
分享
说明
该视图从 V2.2.77 版本开始引入。
功能描述
展示物理恢复任务当前的执行进度。
字段说明
| 字段名称 | 类型 | 是否可以为 NULL | 描述 |
|---|---|---|---|
| TENANT_ID | bigint(20) | NO | 执行恢复任务的租户 ID |
| JOB_ID | bigint(20) | NO | 恢复所属的 job_id, 对应一次恢复任务 |
| RESTORE_TENANT_NAME | longtext | NO | 待恢复的租户名 |
| RESTORE_TENANT_ID | bigint(20) | 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 | 恢复类型。
说明该字段从 V4.3.5 BP1 版本开始引入。 |
| RESTORE_SCN | bigint(20) unsigned | NO | 用户指定的恢复位点 |
| RESTORE_SCN_DISPLAY | varchar(26) | NO | 用户指定的恢复位点的时间戳表示 |
| STATUS | longtext | NO | 恢复状态：系统租户的恢复任务与被恢复租户的恢复任务状态不一致。 系统租户：
被恢复租户：
|
| START_TIMESTAMP | varchar(26) | 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/archive/2_1_2,file:///data/nfs/backup/archive/2_1_3 |
| RECOVER_SCN | bigint(20) unsigned | NO | 日志的恢复位点。对于系统租户，该字段的值为 NULL
说明
|
| RECOVER_SCN_DISPLAY | datetime(6) | NO | 日志的恢复位点的时间戳表示。对于系统租户，该字段的值为 NULL
说明
|
| RECOVER_PROGRESS | decimal(6,2) | NO | 日志恢复的进度，结果保留两位小数，例如：显示 87.65 表示当前进度为 87.65%。对于系统租户，该字段的值为 NULL
说明
|
| TABLET_COUNT | bigint(20) | NO | 待恢复的 Tablet 总数。对于系统租户，该字段的值为 NULL
说明
|
| FINISH_TABLET_COUNT | bigint(20) | NO | 已完成恢复的 Tablet 总数。对于系统租户，该字段的值为 NULL
说明
|
| RESTORE_PROGRESS | decimal(6,2) | NO | 数据恢复进度，结果保留两位小数，例如：显示 87.65 表示当前进度为 87.65%。对于系统租户，该字段的值为 NULL
说明
|
| 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 信息 |
查询示例
查看 mysql 租户物理恢复任务当前的执行进度。
obclient [oceanbase]> SELECT * FROM oceanbase.CDB_OB_RESTORE_PROGRESS WHERE tenant_id IN (SELECT tenant_id FROM oceanbase.DBA_OB_TENANTS WHERE tenant_name='mysql')\G
其中，tenant_name 为恢复的新租户的名称。
查询结果如下：
*************************** 1. row ***************************
TENANT_ID: 1008
JOB_ID: 2
RESTORE_TENANT_NAME: mysql
RESTORE_TENANT_ID: 1008
BACKUP_TENANT_NAME: backup_tenant
BACKUP_TENANT_ID: 1002
BACKUP_CLUSTER_NAME: backup_cluster
BACKUP_DEST: file:///data/nfs/backup//archive,file:///data/nfs/backup/data
RESTORE_OPTION: pool_list=restore_pool&concurrency=50
RESTORE_TYPE: FULL
RESTORE_SCN: 1711091102560245001
RESTORE_SCN_DISPLAY: 2024-03-22 15:05:02.560245
STATUS: RESTORING
START_TIMESTAMP: 2024-03-22 15:06:30.860918
BACKUP_SET_LIST: file:///data/nfs/backup/data/backup_set_1_full
BACKUP_PIECE_LIST: file:///data/nfs/backup/archive/piece_d1001r1p1,file:///data/nfs/backup/archive/piece_d1001r2p2
RECOVER_SCN: 1711084223602400000
RECOVER_SCN_DISPLAY: 2024-03-22 13:10:23.602400
RECOVER_PROGRESS: 72.23
TABLET_COUNT: 1767
FINISH_TABLET_COUNT: 598
RESTORE_PROGRESS: 33.84
TOTAL_BYTES: 23210230
TOTAL_BYTES_DISPLAY: 220.14GB
FINISH_BYTES: 0
FINISH_BYTES_DISPLAY: 0.00MB
DESCRIPTION:
1 rows in set
相关视图或文档
查看所有租户已完成的租户级恢复任务：CDB_OB_RESTORE_HISTORY
查看物理恢复进度的详细操作及说明，参见 查看物理恢复进度。
