Note
This view is available starting with V4.0.0.
Purpose
This view displays the ongoing restore tasks for the current tenant.
Columns
| Column | Type | Nullable? | Description |
|---|---|---|---|
| JOB_ID | bigint(20) | NO | The job ID of the restore task. |
| RESTORE_TENANT_NAME | longtext | NO | The name of the tenant to be restored. |
| RESTORE_TENANT_ID | longtext | NO | The ID of the tenant to be restored. |
| BACKUP_TENANT_NAME | longtext | NO | The name of the source tenant. |
| BACKUP_TENANT_ID | longtext | NO | The ID of the source tenant. |
| BACKUP_CLUSTER_NAME | longtext | NO | The name of the source cluster. |
| BACKUP_DEST | longtext | NO | The path of the backup set, which is the data backup path and log archive path specified by the user. |
| RESTORE_OPTION | longtext | NO | The restore option specified by the user when initiating the restore task. |
| RESTORE_TYPE | varchar(4096) | NO | The restore type.
NoteThis column is available starting with V4.3.5 BP1. |
| RESTORE_SCN | bigint(20) unsigned | NO | The restore point specified by the user. |
| RESTORE_SCN_DISPLAY | datetime(6) | NO | The timestamp of the restore point specified by the user. |
| STATUS | longtext | NO | The restore status: the restore status of the system tenant and the tenant to be restored are inconsistent. System tenant:
Tenant to be restored:
|
| START_TIMESTAMP | datetime(6) | NO | The timestamp when the restore task starts. |
| BACKUP_SET_LIST | longtext | 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 | longtext | NO | The list of log archive shard paths required for the restore task. The shards are separated by commas (,). For 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 system tenant, the value of this column is NULL
Note
|
| RECOVER_SCN_DISPLAY | datetime(6) | NO | The timestamp of the restore point of the log. For the system tenant, the value of this column is NULL
Note
|
| RECOVER_PROGRESS | decimal(6,2) | NO | The restore progress of the log. The value is rounded to two decimal places. For example, 87.65 indicates that the restore progress is 87.65%. For the system tenant, the value of this column is NULL
Note
|
| TABLET_COUNT | bigint(20) | NO | The total number of tablets to be restored. For the system tenant, the value of this column is NULL
Note
|
| FINISH_TABLET_COUNT | bigint(20) | NO | The total number of tablets that have completed the restore. For the system tenant, the value of this column is NULL.
Note
|
| RESTORE_PROGRESS | decimal(6,2) | NO | The restore progress, rounded to two decimal places. For example, 87.65 indicates that the restore progress is 87.65%. For the system tenant, the value of this column is NULL.
Note
|
| TOTAL_BYTES | bigint(20) | NO | The total number of bytes to be restored. |
| TOTAL_BYTES_DISPLAY | varchar(27) | NO | The total number of bytes to be restored, displayed in storage unit. |
| FINISH_BYTES | bigint(20) | NO | The number of bytes that have been restored. |
| FINISH_BYTES_DISPLAY | varchar(27) | NO | The number of bytes that have been restored, displayed in storage unit. |
| DESCRIPTION | longtext | NO | The DESCRIPTION value specified in the restore command. |
Sample query
Query the restore tasks of the current tenant in the sys tenant.
obclient [oceanbase]> SELECT * FROM oceanbase.DBA_OB_RESTORE_PROGRESS\G
The query result is as follows:
*************************** 1. row ***************************
JOB_ID: 4
RESTORE_TENANT_NAME: AUX_RECOVER$1736316932764846
RESTORE_TENANT_ID: 1014
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: 1736316906889750000
RESTORE_SCN_DISPLAY: 2025-01-08 14:15:06.889750
STATUS: WAIT_TENANT_RESTORE_FINISH
START_TIMESTAMP: 2025-01-08 14:15:32.769596
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: NULL
RECOVER_SCN_DISPLAY: NULL
RECOVER_PROGRESS: NULL
TABLET_COUNT: NULL
FINISH_TABLET_COUNT: NULL
RESTORE_PROGRESS: NULL
TOTAL_BYTES: NULL
TOTAL_BYTES_DISPLAY: NULL
FINISH_BYTES: NULL
FINISH_BYTES_DISPLAY: NULL
DESCRIPTION:
1 row in set