---
title: "oceanbase.CDB_OB_RESTORE_HISTORY - OceanBase 数据库 V4.5.0 | OceanBase 文档中心"
description: oceanbase.CDB_OB_RESTORE_HISTORY 说明 该视图从 V2.2.77 版本开始引入。 功能描述 展示物理恢复任务完成时的状态，是恢复任务结束时，对应任务在 oceanbase.CDB_OB_RESTORE_PROGRESS 中对应记录的快照。 字段说明 字段名称 类型 是否可以为 NULL…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.5.0

# oceanbase.CDB_OB_RESTORE_HISTORY

更新时间：2026-03-26 11:33:36

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.5.0/zh-CN/700.reference/700.system-views/300.system-view-of-sys-tenant/200.dictionary-view-of-sys-tenant/10300.o-cdb_ob_restore_history-of-sys-tenant.md)

#### 说明

该视图从 V2.2.77 版本开始引入。

## 功能描述

展示物理恢复任务完成时的状态，是恢复任务结束时，对应任务在 `oceanbase.CDB_OB_RESTORE_PROGRESS` 中对应记录的快照。

## 字段说明

| **字段名称** | **类型** | **是否可以为 NULL** | **描述** |
| --- | --- | --- | --- |
| TENANT_ID | bigint(20) | NO | 执行恢复任务的租户 ID |
| JOB_ID | bigint(20) | NO | 恢复所属 job_id, 对应一次恢复任务 |
| RESTORE_TENANT_NAME | varchar(128) | NO | 恢复的租户名 |
| RESTORE_TENANT_ID | bigint(20) | NO | 恢复的租户 ID |
| BACKUP_TENANT_NAME | varchar(128) | NO | 备份的源租户名 |
| BACKUP_TENANT_ID | bigint(20) | NO | 备份的源租户 ID |
| BACKUP_CLUSTER_NAME | varchar(128) | NO | 备份的源集群名 |
| BACKUP_DEST | longtext | NO | 备份集路径，指用户输入的数据备份路径与日志归档路径 |
| RESTORE_SCN | bigint(20) unsigned | NO | 用户指定的恢复位点 |
| RESTORE_SCN_DISPLAY | varchar(26) | NO | 用户指定的恢复位点的时间戳表示 |
| RESTORE_OPTION | varchar(4096) | NO | 恢复选项，发起恢复时，用户指定的 `restore_option` |
| RESTORE_TYPE | varchar(4096) | NO | 恢复类型。   - `FULL`：表示全量恢复 - `QUICK`：表示快速恢复    #### 说明    该字段从 V4.3.5 BP1 版本开始引入。 |
| START_TIMESTAMP | timestamp(6) | YES | 恢复任务开始时间戳 |
| FINISH_TIMESTAMP | timestamp(6) | YES | 恢复任务结束时间戳 |
| STATUS | varchar(64) | NO | 恢复结果：   - `SUCCESS`：表示恢复成功 - `FAILED`：表示恢复失败 |
| BACKUP_PIECE_LIST | longtext | NO | 恢复依赖的日志归档分片路径列表, 分片间以 `,` 分隔, 例如：`file:///data/nfs/backup/archive/2_1_2,file:///data/nfs/backup/archive/2_1_3` |
| BACKUP_SET_LIST | longtext | NO | 恢复依赖的数据备份集路径列表, 备份集间以 `,` 分隔，例如：`file:///data/nfs/backup/data/backup_set_1_full,file:///data/nfs/backup/data/backup_set_2_inc` |
| BACKUP_CLUSTER_VERSION | bigint(20) | NO | 备份源集群版本号 |
| LS_COUNT | bigint(20) | NO | 恢复日志流总量 |
| FINISH_LS_COUNT | bigint(20) | NO | 完成恢复日志流数量 |
| TABLET_COUNT | bigint(20) | NO | 恢复分片总量 |
| FINISH_TABLET_COUNT | bigint(20) | NO | 完成恢复分片数量 |
| TOTAL_BYTES | bigint(20) | NO | 恢复总字节数 |
| TOTAL_BYTES_DISPLAY | varchar(27) | NO | 恢复总字节数，以存储容量单位显示 |
| FINISH_BYTES | bigint(20) | NO | 完成恢复字节数 |
| FINISH_BYTES_DISPLAY | varchar(27) | NO | 完成恢复字节数，以存储容量单位显示 |
| DESCRIPTION | varchar(1024) | YES | 恢复命令里指定的 `DESCRIPTION` 信息 |
| COMMENT | varchar(1024) | YES | 恢复失败时记录失败信息 |

## 查询示例

系统租户查看恢复任务完成时的状态。

```shell
obclient [oceanbase]> SELECT * FROM oceanbase.CDB_OB_RESTORE_HISTORY\G

```

查询结果如下：

```shell
*************************** 1. row ***************************
             TENANT_ID: 1
                JOB_ID: 1
   RESTORE_TENANT_NAME: mysql_test
     RESTORE_TENANT_ID: 1006
    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_SCN: 1736236006946129000
   RESTORE_SCN_DISPLAY: 2025-01-07 15:46:46.946129
        RESTORE_OPTION: pool_list=rptest
          RESTORE_TYPE: FULL
       START_TIMESTAMP: 2025-01-07 15:48:35.993556
      FINISH_TIMESTAMP: 2025-01-07 15:51:11.301331
                STATUS: FAIL
     BACKUP_PIECE_LIST: file:///home/admin/oceanbase/arglog/piece_d1001r1p1
       BACKUP_SET_LIST: file:///home/admin/oceanbase/backupdata/backup_set_3_full
BACKUP_CLUSTER_VERSION: 17180001538
              LS_COUNT: 0
       FINISH_LS_COUNT: 0
          TABLET_COUNT: 0
   FINISH_TABLET_COUNT: 0
           TOTAL_BYTES: 0
   TOTAL_BYTES_DISPLAY: 0.00MB
          FINISH_BYTES: 0
  FINISH_BYTES_DISPLAY: 0.00MB
           DESCRIPTION: NULL
               COMMENT: ROOTSERVICE : OB_TENANT_NOT_EXIST(-5157) on "172.xx.xxx.xxx:2882" with traceid YB42xxxxxxxx-xxxxxxxxxxxxxxxxx-x-x
1 row in set

```

## 相关视图或文档

- 查看所有租户物理恢复任务当前的执行进度：[CDB_OB_RESTORE_PROGRESS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477691)
 - 查看物理恢复结果的详细操作及说明，参见 [查看物理恢复结果](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004475978)。

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线