Overview
Displays the ongoing restore tasks for the current tenant.
Columns
Field Name |
Type |
Whether can be NULL |
Description |
|---|---|---|---|
| JOB_ID | bigint(20) | NO | Recovery Job ID, Corresponding to a Recovery Task |
| RESTORE_TENANT_NAME | longtext | NO | Tenant name to be restored |
| RESTORE_TENANT_ID | longtext | NO | Tenant ID to be Restored |
| BACKUP_TENANT_NAME | longtext | NO | Name of the source tenant for backup |
| BACKUP_TENANT_ID | longtext | NO | Source Tenant ID for Backup |
| BACKUP_CLUSTER_NAME | longtext | NO | Source cluster name for backup |
| BACKUP_DEST | longtext | NO | Backup set path, which refers to the data backup path and log archive path entered by the user. |
| RESTORE_OPTION | longtext | NO | Recovery options, specified by the user when initiating recovery. restore_option |
| RESTORE_TYPE | varchar(4096) | NO | The restore type.
|
| RESTORE_SCN | bigint(20) unsigned | NO | User-specified restore point |
| RESTORE_SCN_DISPLAY | datetime(6) | NO | The timestamp of the user-specified restore point is represented as |
| STATUS | longtext | NO | Recovery status: The recovery task status of the system tenant is inconsistent with that of the tenant being recovered. System tenant:
Restored tenant:
|
| START_TIMESTAMP | datetime(6) | NO | Restored Task Start Timestamp |
| BACKUP_SET_LIST | longtext | NO | List of data backup set paths to restore. Separate backup sets with commas (,). , Separate them with commas, for example: file:///data/nfs/backup/data/backup_set_1_full,file:///data/nfs/backup/data/backup_set_2_inc |
| BACKUP_PIECE_LIST | longtext | NO | List of log archive shard paths to restore. Separate shards with commas. , Separate them with commas. Example: file:///data/nfs/backup/data/backup_set_1_full,file:///data/nfs/backup/data/backup_set_2_inc |
| RECOVER_SCN | bigint(20) unsigned | NO | The restore point of the log. For the sys tenant, the value of this field is NULL |
| RECOVER_SCN_DISPLAY | datetime(6) | NO | The timestamp represents the point in time to which logs are to be restored. For the sys tenant, the value of this field is NULL |
| RECOVER_PROGRESS | decimal(6,2) | NO | The progress of log restore, with results rounded to two decimal places. For example: 87.65 Indicates that the current progress is 87.65%. For the sys tenant, the value of this field is NULL |
| TABLET_COUNT | bigint(20) | NO | Total number of tablets to be restored. For the sys tenant, the value of this field is NULL |
| FINISH_TABLET_COUNT | bigint(20) | NO | Total number of restored tablets. For the sys tenant, the value of this field is NULL |
| RESTORE_PROGRESS | decimal(6,2) | NO | Data recovery progress, with results rounded to two decimal places. For example: 87.65 Indicates that the current progress is 87.65%. For the sys tenant, the value of this field is NULL |
| TOTAL_BYTES | bigint(20) | NO | Total Bytes Restored |
| TOTAL_BYTES_DISPLAY | varchar(27) | NO | Total bytes restored, displayed in storage capacity units |
| FINISH_BYTES | bigint(20) | NO | Number of bytes restored |
| FINISH_BYTES_DISPLAY | varchar(27) | NO | Number of bytes restored, in storage capacity units |
| DESCRIPTION | longtext | NO | Specified in the restore command DESCRIPTION Information |
Sample query
You can query the restore tasks in progress for the current tenant.
obclient [oceanbase]> SELECT * FROM oceanbase.DBA_OB_RESTORE_PROGRESS\G
The query result is as follows:
*************************** 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
References
View the current execution progress of all tenant physical restore tasks: CDB_OB_RESTORE_PROGRESS
View all completed tenant-level restore tasks for a tenant: CDB_OB_RESTORE_HISTORY
For detailed operations and descriptions on viewing the physical restore progress, see View the physical restore progress.