Note
This view is available starting with V4.0.0.
Purpose
This view displays the active restore tasks for the current tenant.
Columns
Column |
Type |
Nullable |
Description |
|---|---|---|---|
| JOB_ID | NUMBER(38) | NO | The job ID of the restore task. |
| RESTORE_TENANT_NAME | VARCHAR2(4096) | NO | The name of the tenant to be restored. |
| RESTORE_TENANT_ID | NUMBER(38) | NO | The ID of the tenant to be restored. |
| BACKUP_TENANT_NAME | VARCHAR2(4096) | NO | The name of the source tenant for the backup. |
| BACKUP_TENANT_ID | VARCHAR2(4096) | NO | The ID of the source tenant for the backup. |
| BACKUP_CLUSTER_NAME | VARCHAR2(4096) | NO | The name of the source cluster for the backup. |
| BACKUP_DEST | VARCHAR2(4096) | NO | The backup set path, which is the data backup path and log archive path specified by the user. |
| RESTORE_OPTION | VARCHAR2(4096) | NO | The restore option specified by the user when initiating the restore task. |
| RESTORE_TYPE | VARCHAR2(4096) | NO | The type of restore.
NoteThis column is available starting with V4.3.5 BP1. |
| RESTORE_SCN | NUMBER(38) | NO | The restore point specified by the user. |
| RESTORE_SCN_DISPLAY | TIMESTAMP(9) | NO | The timestamp of the restore point specified by the user. |
| STATUS | VARCHAR2(4096) | NO | The status of the restore task. The status of the restore task for the system tenant and the tenant to be restored may be inconsistent. System tenant:
Tenant to be restored:
|
| START_TIMESTAMP | VARCHAR2(256) | NO | The timestamp when the restore task starts. |
| BACKUP_SET_LIST | VARCHAR2(4096) | NO | The list of data backup set paths required for the restore task. The backup sets are separated by commas (,). For example: file:///data/nfs/backup/data/backup_set_1_full,file:///data/nfs/backup/data/backup_set_2_inc |
| BACKUP_PIECE_LIST | VARCHAR2(4096) | NO | The list of log archive piece paths required for the restore task. The log archive pieces are separated by commas (,). For example: file:///data/nfs/backup/archive/2_1_2,file:///data/nfs/backup/archive/2_1_3 |
| RECOVER_SCN | NUMBER(38) | NO | The restore point of the log. For the system tenant, the value of this column is NULL
Note
|
| RECOVER_SCN_DISPLAY | TIMESTAMP(9) | NO | The timestamp of the restore point of the log. For the system tenant, the value of this column is NULL
Note
|
| RECOVER_PROGRESS | NUMBER | NO | The progress of log recovery. The result is rounded to two decimal places. For example, 87.65 indicates that the progress is 87.65%. For the system tenant, the value of this column is NULL
Note
|
| TABLET_COUNT | NUMBER(38) | NO | The total number of tablets to be restored. For the system tenant, the value of this column is NULL
Note
|
| FINISH_TABLET_COUNT | NUMBER(38) | NO | The total number of tablets that have been restored. For the system tenant, the value of this column is NULL
Note
|
| RESTORE_PROGRESS | NUMBER | NO | The progress of data recovery. The result is rounded to two decimal places. For example, 87.65 indicates that the progress is 87.65%. For the system tenant, the value of this column is NULL
Note
|
| TOTAL_BYTES | NUMBER(38) | NO | The total number of bytes to be restored. |
| TOTAL_BYTES_DISPLAY | VARCHAR2(42) | NO | The total number of bytes to be restored, displayed in the storage capacity unit. |
| FINISH_BYTES | NUMBER(38) | NO | The number of bytes that are completed in the restore. |
| FINISH_BYTES_DISPLAY | VARCHAR2(42) | NO | The total number of bytes that are restored, displayed in storage units. |
| DESCRIPTION | VARCHAR2(4096) | NO | The DESCRIPTION information specified in the restore command. |
Sample query
Query the progress of physical restore tasks in the current user's tenant.
obclient [SYS]> SELECT * FROM SYS.DBA_OB_RESTORE_PROGRESS\G
The query result is as follows:
*************************** 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
References
View the execution progress of all physical restore tasks in all tenants: CDB_OB_RESTORE_PROGRESS
View all completed tenant-level restore tasks in all tenants: CDB_OB_RESTORE_HISTORY
For more information about how to view the progress of a physical restore task, see View the progress of a physical restore task.