--- title: "oceanbase.DBA_OB_RESTORE_HISTORY - OceanBase 数据库 V4.3.5 | OceanBase 文档中心" description: oceanbase.DBA_OB_RESTORE_HISTORY 说明 该视图从 V4.0.0 版本开始引入。 功能描述 展示当前租户已完成的租户级恢复任务。 字段说明 字段名称 类型 是否可以为 NULL 描述 JOB_ID bigint(20) NO 恢复所属 job_id, 对应一次恢复任务 RESTORE_T… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.3.5 LTS # oceanbase.DBA_OB_RESTORE_HISTORY 更新时间：2026-07-13 22:33:26 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.3.5/zh-CN/700.reference/700.system-views/300.system-view-of-sys-tenant/200.dictionary-view-of-sys-tenant/21100.o-dba_ob_restore_history-of-sys-tenant.md) #### 说明 该视图从 V4.0.0 版本开始引入。 ## 功能描述 展示当前租户已完成的租户级恢复任务。 ## 字段说明 | 字段名称 | 类型 | 是否可以为 NULL | 描述 | | --- | --- | --- | --- | | 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 | datetime(6) | 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.DBA_OB_RESTORE_HISTORY\G ``` 查询结果如下所示： ```shell *************************** 1. row *************************** 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: QUICK 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 *************************** 2. row *************************** JOB_ID: 2 RESTORE_TENANT_NAME: AUX_RECOVER$1736237253959061 RESTORE_TENANT_ID: 1008 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: 1736237207609421000 RESTORE_SCN_DISPLAY: 2025-01-07 16:06:47.609421 RESTORE_OPTION: pool_list=rptest RESTORE_TYPE: QUICK START_TIMESTAMP: 2025-01-07 16:07:33.973129 FINISH_TIMESTAMP: 2025-01-07 16:11:24.689245 STATUS: SUCCESS BACKUP_PIECE_LIST: file:///home/admin/oceanbase/arglog/piece_d1001r1p1 BACKUP_SET_LIST: file:///home/admin/oceanbase/backupdata/backup_set_4_full BACKUP_CLUSTER_VERSION: 17180001538 LS_COUNT: 2 FINISH_LS_COUNT: 0 TABLET_COUNT: 676 FINISH_TABLET_COUNT: 676 TOTAL_BYTES: 21145561 TOTAL_BYTES_DISPLAY: 20.17MB FINISH_BYTES: 0 FINISH_BYTES_DISPLAY: 0.00MB DESCRIPTION: NULL COMMENT: 2 rows in set ``` 上一篇 下一篇 ![有帮助](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) 咨询热线