查看按表恢复进度

表级恢复命令执行成功后，您可以通过视图查看按表恢复的进度。

操作步骤

1. 使用 root 用户登录表待恢复的目标租户所在集群的 sys 租户。

2. 查看按表恢复的进度。

   系统租户可以通过视图 CDB_OB_RECOVER_TABLE_JOBS 查看整个按表恢复的进度。

   obclient [(none)]> SELECT * FROM oceanbase.CDB_OB_RECOVER_TABLE_JOBS\G
   

   查询结果的示例如下：

   *************************** 1. row ***************************
                  TENANT_ID: 1
                     JOB_ID: 1
        INITIATOR_TENANT_ID: 1
           INITIATOR_JOB_ID: 0
            START_TIMESTAMP: 2023-06-01 06:00:00.000000
                     STATUS: RECOVERING
            AUX_TENANT_NAME: AUX_RECOVER$1692106995896258
         TARGET_TENANT_NAME: backup_tenant
                 IMPORT_ALL: 0
                    DB_LIST: 
                 TABLE_LIST: `TEST`.`T1`
                RESTORE_SCN: 1692104831498747191
        RESTORE_SCN_DISPLAY: 2023-06-01 00:00:00.000000
             RESTORE_OPTION: pool_list=small_pool_0&primary_zone=z1
                BACKUP_DEST: file:///data2/nfs/ob_backup_oracle_tenant/archive,file:///data2/nfs/ob_backup_oracle_tenant/data
            BACKUP_SET_LIST: file:///data2/nfs/ob_backup_oracle_tenant/data/backup_set_1_full
          BACKUP_PIECE_LIST: file:///data2/nfs/ob_backup_oracle_tenant/archive/piece_d1001r1p1
              BACKUP_PASSWD: NULL
          EXTERNAL_KMS_INFO: NULL
              REMAP_DB_LIST: 
           REMAP_TABLE_LIST: `TEST`.`T1`:`RECOVER_TEST`.`T3`
      REMAP_TABLEGROUP_LIST:
      REMAP_TABLESPACE_LIST:
                     RESULT: 
                    COMMENT: 
   1 row in set
   

   该视图记录了执行恢复时用户输入的恢复参数信息以及恢复结果等信息。

   按表恢复的整个过程包括辅助租户的恢复操作和跨租户的导入操作。视图 CDB_OB_RECOVER_TABLE_JOBS 中对应两条任务记录：一条 sys 租户的任务记录和一条目标用户租户自身的任务记录。其中：

   • sys 租户的任务记录主要记录目标用户租户的按表恢复的进度。当目标租户的整个按表恢复任务结束，则表示该任务结束。

   • 目标用户租户自身的任务记录包括辅助租户的恢复进度和表导入任务的进度。当辅助租户的恢复任务和表的导入任务均结束，则表示该任务结束。

   查询结果中，AUX_RECOVER$1692106995896258 为辅助租户，backup_tenant 为目标用户租户，需要恢复的表为 TEST.T1，STATUS 表示按表恢复当前的阶段：

   • PREPARE：任务初始化阶段
   • RECOVERING：等待目标租户完成恢复中，仅 sys 租户会显示该状态。
   • RESTORE_AUX_TENANT：恢复辅助租户
   • PRECHECK_IMPORT：导入前检查
   • GEN_IMPORT_JOB：导入任务初始化
   • IMPORTING：表导入中
   • CANCELING：任务取消中
   • COMPLETED：任务完成
   • FAILED：任务失败

   如果视图中 STATUS 的值为 COMPLETED，则表示按表恢复完成。有关视图 CDB_OB_RECOVER_TABLE_JOBS 中字段的详细说明，请参见 按表恢复相关视图介绍。

3. 按表恢复未完成前，您可以根据按表恢复所处的阶段，查看辅助租户恢复任务的进度和目标租户导入任务的进度。

   • 辅助租户恢复过程中，查看辅助租户恢复任务的进度。

     obclient [(none)]> SELECT * FROM oceanbase.CDB_OB_RESTORE_PROGRESS\G
     

     辅助租户的恢复与租户级的物理恢复过程一致，有关查看物理恢复进度的详细介绍，请参见 查看物理恢复进度。

   • 表导入过程中，查看目标租户导入任务的进度。

     obclient [(none)]> SELECT * FROM oceanbase.CDB_OB_IMPORT_TABLE_JOBS\G
     

     查询结果的示例如下：

     *************************** 1. row ***************************
                 TENANT_ID: 1010
                    JOB_ID: 3
       INITIATOR_TENANT_ID: 1010
          INITIATOR_JOB_ID: 2
           START_TIMESTAMP: 2023-08-16 17:59:28.689435
           SRC_TENANT_NAME: AUX_RECOVER$1692179849034890
             SRC_TENANT_ID: 1014
                    STATUS: IMPORT_TABLE
                IMPORT_ALL: 0
                   DB_LIST:
                TABLE_LIST: `TEST`.`T1`
             REMAP_DB_LIST:
          REMAP_TABLE_LIST: `TEST`.`T1`:`RECOVER_TEST`.`T3`
     REMAP_TABLEGROUP_LIST:
     REMAP_TABLESPACE_LIST:
         TOTAL_TABLE_COUNT: 0
      FINISHED_TABLE_COUNT: 0
        FAILED_TABLE_COUNT: 0
                    RESULT:
                   COMMENT:
     1 row in set
     

     根据查询结果，STATUS 为 IMPORT_TABLE，表示正在导入表 TEST.T1。在表导入过程中，您还可以查看每张表导入的详细信息。

     obclient [(none)]> SELECT * FROM oceanbase.CDB_OB_IMPORT_TABLE_TASKS\G
     

     查询结果的示例如下：

     *************************** 1. row ***************************
                         TENANT_ID: 1002
                           TASK_ID: 1047
                            JOB_ID: 3
                     SRC_TENANT_ID: 1004
                    SRC_TABLESPACE: NULL
                    SRC_TABLEGROUP: NULL
                      SRC_DATABASE: test
                         SRC_TABLE: t1
                     SRC_PARTITION: NULL
                 TARGET_TABLESPACE: NULL
                 TARGET_TABLEGROUP: NULL
                   TARGET_DATABASE: recover_test
                      TARGET_TABLE: t3
                      TABLE_COLUMN: 7
                            STATUS: DOING
                   START_TIMESTAMP: 2023-08-16 21:08:49.492389
              COMPLETION_TIMESTAMP: 
                     CUMULATIVE_TS: -1
                 TOTAL_INDEX_COUNT: 2
              IMPORTED_INDEX_COUNT: 0
                FAILED_INDEX_COUNT: 0
            TOTAL_CONSTRAINT_COUNT: 1
         IMPORTED_CONSTRAINT_COUNT: 0
           FAILED_CONSTRAINT_COUNT: 0
        TOTAL_REF_CONSTRAINT_COUNT: 1
     IMPORTED_REF_CONSTRAINT_COUNT: 0
       FAILED_REF_CONSTRAINT_COUNT: 0
                            RESULT: 
                           COMMENT:
     1 row in set
     

   有关 CDB_OB_IMPORT_TABLE_JOBS、CDB_OB_IMPORT_TABLE_TASKS 等视图中字段的详细说明，请参见 按表恢复相关视图介绍。