---
title: "执行全量恢复 | OceanBase 文档中心"
description: 执行全量恢复 本节主要介绍如何通过命令的方式进行租户级物理恢复，目前 OceanBase 数据库支持租户级别的基于时间点的全量恢复。 OceanBase 数据库的恢复支持在同集群内恢复，也支持在不同的集群内恢复。 恢复会先根据用户输入的命令，从备份目的端将需要的宏块数据从对应的全量备份和增量备份中恢复到目标租户，并同…
---
切换语言

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

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

# 执行全量恢复

更新时间：2026-06-29 11:07:36

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.0.0/zh-CN/500.administrator-guide/1000.high-data-availability/200.backup-and-restoration-management/600.restore-data/200.initiate-the-tenant-restore.md)  

本节主要介绍如何通过命令的方式进行租户级物理恢复，目前 OceanBase 数据库支持租户级别的基于时间点的全量恢复。

OceanBase 数据库的恢复支持在同集群内恢复，也支持在不同的集群内恢复。

恢复会先根据用户输入的命令，从备份目的端将需要的宏块数据从对应的全量备份和增量备份中恢复到目标租户，并同步拉取和回放事务日志。

## 前提条件

执行全量恢复前，请确认已完成恢复前准备，具体操作请参见 [恢复前准备](https://www.oceanbase.com/docs/community-observer-cn-10000000000901798)。

## 执行全量恢复

1. 使用 `root` 用户登录数据库的 `sys` 租户。
 2. 执行以下语句，开始执行恢复任务。

   语句如下：

      - 恢复到指定时间戳

       ```sql
       obclient> ALTER SYSTEM RESTORE dest_tenant_name FROM uri UNTIL TIME=timestamp WITH restore_option [DESCRIPTION description];

       ```
      - 恢复到指定 SCN

       ```sql
       obclient> ALTER SYSTEM RESTORE dest_tenant_name FROM uri UNTIL SCN=scn WITH restore_option [DESCRIPTION description];

       ```
      - 恢复到最新位点

       ```sql
       obclient> ALTER SYSTEM RESTORE dest_tenant_name FROM uri WITH restore_option [DESCRIPTION description];

       ```

   其中 `uri` 需要分别指定数据备份路径和日志归档路径, `UNTIL [TIME|SCN]` 指用户指定的恢复终点,恢复到该位点为止，但不包括该位点。`restore_option` 支持指定 `pool_list`、`locality`、`primary_zone`、`kms_encrypt`,`pool_list` 为必选项，其余为可选项。 语句中各参数的详细说明请参见 [RESTORE](https://www.oceanbase.com/docs/community-observer-cn-10000000000901334)。

   恢复示例如下：

      - NFS

            - 从数据备份路径 `file:///data/nfs/backup/data` 与日志归档路径 `file:///data/nfs/backup/archive` 恢复租户 `mysql` 到指定时间戳 `2022-06-1 00:00:00`, 指定资源池为 `restore_pool`

             ```sql
             obclient> ALTER SYSTEM RESTORE mysql FROM 'file:///data/nfs/backup/data,file:///data/nfs/backup/archive' until TIME='2022-06-1 00:00:00' WITH 'pool_list=restore_pool';

             ```
            - 从数据备份路径 `file:///data/nfs/backup/data` 与日志归档路径 `file:///data/nfs/backup/archive` 恢复租户 `mysql` 恢复到当前最新的归档位点, 指定资源池为 `restore_pool`

             ```sql
             obclient> ALTER SYSTEM RESTORE mysql FROM 'file:///data/nfs/backup/data,file:///data/nfs/backup/archive' WITH 'pool_list=restore_pool';

             ```
            - 从数据备份路径 `file:///data/nfs/backup/data` 与日志归档路径 `file:///data/nfs/backup/archive` 恢复租户 `mysql` 到指定 scn `1658285759724047000`, 指定资源池为 `restore_pool`

             ```sql
             obclient> ALTER SYSTEM RESTORE mysql FROM 'file:///data/nfs/backup/data,file:///data/nfs/backup/archive' until SCN='1658285759724047000' WITH 'pool_list=restore_pool';

             ```
            - 从数据备份路径 `file:///data/nfs/backup/data` 与日志归档路径 `file:///data/nfs/backup/archive` 恢复租户 `mysql` 到指定时间戳 `2022-06-1 00:00:00`, 指定资源池为 `restore_pool`, 副本 Locality 为 `F@z1,F@z2,F@z3`。

             ```sql
             obclient> ALTER SYSTEM RESTORE mysql FROM 'file:///data/nfs/backup/data,file:///data/nfs/backup/archive' until TIME='2022-06-1 00:00:00' WITH 'pool_list=restore_pool&locality=F@z1,F@z2,F@z3';

             ```
            - 从数据备份路径 `file:///data/nfs/backup/data` 与日志归档路径 `file:///data/nfs/backup/archive` 恢复租户 `mysql` 到指定时间戳 `2022-06-1 00:00:00`, 指定资源池为 `restore_pool`, 副本 Locality 为 `F@z1,F@z2,F@z3`, 并指定 `primary_zone` 为 `z1`。

             ```sql
             obclient> ALTER SYSTEM RESTORE mysql FROM 'file:///data/nfs/backup/data,file:///data/nfs/backup/archive' until TIME='2022-06-1 00:00:00' WITH 'pool_list=restore_pool&locality=F@z1,F@z2,F@z3&primary_zone=z1';

             ```
      - OSS

       除 `url` 参数有所变更外, 其余参数使用与 `NFS` 一致。

            - 从 OSS 备份路径 `oss://oceanbase-test-bucket/backup/data/?host=xxx.aliyun-inc.com&access_id=xxx&access_key=xxx` 与 OSS 日志归档路径 `oss://oceanbase-test-bucket/backup/archive/?host=xxx.aliyun-inc.com&access_id=xxx&access_key=xxx`恢复租户 `mysql` 到指定时间戳 `2022-06-1 00:00:00`, 指定资源池为 `restore_pool`。

             ```sql
             obclient> ALTER SYSTEM RESTORE mysql FROM 'oss://oceanbase-test-bucket/backup/data/?host=xxx.aliyun-inc.com&access_id=xxx&access_key=xxx,oss://oceanbase-test-bucket/backup/archive/?host=xxx.aliyun-inc.com&access_id=xxx&access_key=xxx' until TIME='2022-06-1 00:00:00' WITH 'pool_list=restore_pool';

             ```

   发起恢复任务后，您可以通过视图查看恢复的进度和结果，具体操作请参见 [查看恢复进度](https://www.oceanbase.com/docs/community-observer-cn-10000000000901801)。

 上一篇 下一篇 ![有帮助](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) 咨询热线