---
title: "使用 BACKUP DATABASE PLUS ARCHIVELOG 功能创建备租户 - OceanBase 数据库 V4.2.1 | OceanBase 文档中心"
description: 使用 BACKUP DATABASE PLUS ARCHIVELOG 功能创建备租户 使用 BACKUP DATABASE PLUS ARCHIVELOG 功能创建备租户的实现方法是，将主租户的所有数据和归档日志在本机或共享存储上生成一份带有归档日志的完整的数据集，再将该数据集上传到待创建的备租户所在集群可以访问的介…
---
切换语言

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

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

# 使用 BACKUP DATABASE PLUS ARCHIVELOG 功能创建备租户

更新时间：2026-04-16 00:11:35

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.2.1/zh-CN/600.manage/400.high-availability/300.physical-standby-database-disaster-recovery/200.create-a-standby-tenant/400.create-a-standby-tenant-by-backup-database-plus-archivelog.md)  

使用 BACKUP DATABASE PLUS ARCHIVELOG 功能创建备租户的实现方法是，将主租户的所有数据和归档日志在本机或共享存储上生成一份带有归档日志的完整的数据集，再将该数据集上传到待创建的备租户所在集群可以访问的介质上，最后使用数据集恢复出一个备租户。

## 步骤一：主租户开启归档模式并执行数据备份

1. 使用管理员用户登录主租户或主租户所在集群的 `sys` 租户。
 2. 主租户开启归档模式。

      1. 设置归档目的端。

        对于主租户为单机的场景，您可以将租户副本所在机器（observer 进程所在的机器）的一个可以访问路径作为归档目的端。对于其他场景，需要使用共享存储（例如，NFS 或 阿里云 OSS）作为归档目的端。

        假设归档介质使用 NFS，归档目的端路径为 `/data/1/sh_archive/`，示例如下：

             - 主租户所在集群的 `sys` 租户设置主租户的归档目的端

              ```sql
              ALTER SYSTEM SET LOG_ARCHIVE_DEST = 'LOCATION=file:///data/1/sh_archive' TENANT = mysql;

              ```

              其中，`mysql` 为指定的主租户名。
             - 主租户设置本租户的归档目的端

              ```sql
              ALTER SYSTEM SET LOG_ARCHIVE_DEST = 'LOCATION=file:///data/1/sh_archive';

              ```

        设置归档目的端的详细操作，请参见 [日志归档的准备工作](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000218397)。
      2. 开启归档模式。

        #### 注意

        为了保证数据备份期间的日志都能被归档，必须先开启租户的归档模式后，再执行数据备份。

             - 主租户所在集群的 `sys` 租户开启主租户的归档模式

              ```sql
              ALTER SYSTEM ARCHIVELOG TENANT = mysql;

              ```

              其中，`mysql` 为指定的主租户名。
             - 主租户开启本租户的归档模式

              ```sql
              ALTER SYSTEM ARCHIVELOG;

              ```

        开启归档模式的详细操作，请参见 [开启归档模式](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000218401)。
      3. 确认归档状态是否为 `DOING`。

        主租户通过查询 `DBA_OB_ARCHIVELOG` 视图（系统租户查询 `CDB_OB_ARCHIVELOG` 视图）确认归档状态的语句如下：

             - 系统租户

              ```sql
              SELECT DEST_ID, ROUND_ID, DEST_NO, STATUS, CHECKPOINT_SCN, CHECKPOINT_SCN_DISPLAY, PATH FROM oceanbase.CDB_OB_ARCHIVELOG;

              ```
             - MySQL 租户

              ```sql
              SELECT DEST_ID, ROUND_ID, DEST_NO, STATUS, CHECKPOINT_SCN, CHECKPOINT_SCN_DISPLAY, PATH FROM oceanbase.DBA_OB_ARCHIVELOG;

              ```
             - Oracle 租户

              ```sql
              SELECT DEST_ID, ROUND_ID, DEST_NO, STATUS, CHECKPOINT_SCN, CHECKPOINT_SCN_DISPLAY, PATH FROM SYS.DBA_OB_ARCHIVELOG;

              ```

        查询结果的示例如下：

        ```sql
        +---------+----------+---------+--------+---------------------+----------------------------+--------------------------------+
        | DEST_ID | ROUND_ID | DEST_NO | STATUS | CHECKPOINT_SCN      | CHECKPOINT_SCN_DISPLAY     | PATH                           |
        +---------+----------+---------+--------+---------------------+----------------------------+--------------------------------+
        |    1001 |        1 |       0 | DOING  | 1680867152120380679 | 2023-04-07 19:32:32.120380 | file:///data/1/xianlin_archive |
        +---------+----------+---------+--------+---------------------+----------------------------+--------------------------------+
        1 row in set

        ```

        根据查询结果，`STATUS` 的值为 `DOING`，表示归档处于正常工作状态。

        查看归档状态的详细操作，请参见 [查看归档进度](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000218396)。
 3. 主租户使用 BACKUP DATABASE PLUS ARCHIVELOG 功能执行数据备份。

   开启归档模式后，主租户需要使用 BACKUP DATABASE PLUS ARCHIVELOG 功能执行一次数据备份，生成一份带有归档日志的完整数据集。

      1. 设置数据备份的备份目的端。

        对于主租户为单机的场景，您可以将租户副本所在机器（observer 进程所在的机器）的一个可以访问路径作为备份目的端，且备份目的端与归档目的端的路径不能相同。其他场景，需要使用共享存储（例如，NFS 或 阿里云 OSS）作为备份目的端。

        假设备份介质使用 NFS，备份目的端路径为 `/data/1/sh_databackup`，示例如下：

             - 主租户所在集群的 `sys` 租户设置主租户的备份目的端

              ```sql
              ALTER SYSTEM SET DATA_BACKUP_DEST = 'file:///data/1/sh_databackup' TENANT = mysql;

              ```

              其中，`mysql` 为指定的主租户名。
             - 主租户设置本租户的备份目的端

              ```sql
              ALTER SYSTEM SET DATA_BACKUP_DEST = 'file:///data/1/sh_databackup';

              ```

        设置备份目的端的详细操作，请参见 [备份前准备](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000218409)。
      2. 执行数据备份。

             - 主租户所在集群的 `sys` 租户对主租户执行数据备份

              ```sql
              ALTER SYSTEM BACKUP TENANT = mysql PLUS ARCHIVELOG;

              ```

              其中，`mysql` 为指定的主租户名。
             - 主租户执行数据备份

              ```sql
              ALTER SYSTEM BACKUP DATABASE PLUS ARCHIVELOG;

              ```
      3. 确认数据备份状态。

        主租户下通过 `DBA_OB_BACKUP_JOBS` 视图（系统租户查询 `CDB_OB_BACKUP_JOBS` 视图）查询数据备份进度的 SQL 语句如下：

             - 系统租户

              ```sql
              SELECT * FROM oceanbase.CDB_OB_BACKUP_JOBS;

              ```sql
              SELECT * FROM oceanbase.DBA_OB_BACKUP_JOBS;

              ```sql
              SELECT * FROM SYS.DBA_OB_BACKUP_JOBS;

              ```

        如果备份正在执行，则该视图中会显示备份任务的进度信息。查看数据备份进度的详细操作，请参见 [查看数据备份进度](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000218414)。

        如果备份已完成，可以通过 `DBA_OB_BACKUP_JOB_HISTORY` 视图（系统租户查询 `CDB_OB_BACKUP_JOB_HISTORY` 视图）进一步查询数据备份历史。

             - 系统租户

              ```sql
              SELECT * FROM oceanbase.CDB_OB_BACKUP_JOB_HISTORY;

              ```sql
              SELECT * FROM oceanbase.DBA_OB_BACKUP_JOB_HISTORY;

              ```sql
              SELECT * FROM SYS.DBA_OB_BACKUP_JOB_HISTORY;

              ```

        查询数据备份历史的结果如下：

        ```shell
        +--------+-------------+---------------+---------------------+------------------+--------------------+-----------------+-------------+-------------+-----------------+--------+----------------------------+----------------------------+-----------+--------+---------+-------------+-------------------------------+
        | JOB_ID | INCARNATION | BACKUP_SET_ID | INITIATOR_TENANT_ID | INITIATOR_JOB_ID | EXECUTOR_TENANT_ID | PLUS_ARCHIVELOG | BACKUP_TYPE | JOB_LEVEL   | ENCRYPTION_MODE | PASSWD | START_TIMESTAMP            | END_TIMESTAMP              | STATUS    | RESULT | COMMENT | DESCRIPTION | PATH                          |
        +--------+-------------+---------------+---------------------+------------------+--------------------+-----------------+-------------+-------------+-----------------+--------+----------------------------+----------------------------+-----------+--------+---------+-------------+-------------------------------+
        |      1 |           1 |             1 |                1004 |                0 | 1004               | ON              | FULL        | USER_TENANT | NONE            |        | 2023-04-07 19:52:35.361398 | 2023-04-07 19:58:57.223196 | COMPLETED |      0 |         |             | file:///data/1/sh_databackup |
        +--------+-------------+---------------+---------------------+------------------+--------------------+-----------------+-------------+-------------+-----------------+--------+----------------------------+----------------------------+-----------+--------+---------+-------------+-------------------------------+
        1 row in set

        ```

        根据查询结果，当 `STATUS` 的值为 `COMPLETED` 时，表示数据备份已完成。`PLUS_ARCHIVELOG` 列显示为 `ON`，表示使用的是 BACKUP DATABASE PLUS ARCHIVELOG 功能执行的数据备份，这样的备份目录下包含了数据库运行所必需的归档日志，两者一起构成了一份带有归档日志的完整数据集。

## （可选）步骤二：主租户关闭归档模式

使用 BACKUP DATABASE PLUS ARCHIVELOG 功能执行数据备份后，如果不再需要持续进行日志归档了，可以关闭主租户的归档模式。

1. 使用管理员用户登录主租户或主租户所在集群的 `sys` 租户。
 2. 执行以下命令，关闭主租户的归档模式。

      - 主租户所在集群的 `sys` 租户关闭主租户的归档模式

       ```sql
       ALTER SYSTEM NOARCHIVELOG TENANT = mysql;

       ```

       其中，`mysql` 为指定的主租户名。
      - 主租户关闭本租户的归档模式

       ```sql
       ALTER SYSTEM NOARCHIVELOG;

       ```

## 步骤三：获取数据备份并放置在备租户可以访问的位置

1. 从设置的备份目的端处获取主租户的数据备份。

   例如，本文示例中，主租户数据备份的存放路径为 `/data/1/sh_databackup`。
 2. 将获取的数据备份，放置在待创建的备租户可以访问的位置。

   例如，对于主租户为单机的场景，只需要将数据备份打包并拷贝到备租户副本所在机器（observer 进程所在的机器）的一个可以访问的路径上。对于其他场景，可以放置在备租户可以访问的共享存储（例如，NFS 或 阿里云 OSS）上。

## 步骤四：使用带有归档日志的完整数据集恢复出租户

1. 使用 `root` 用户登录到待创建的备租户所在集群的 `sys` 租户。
 2. 执行以下命令，创建备租户所需的 Unit 规格。

   创建新备租户所需的 Unit 规格时，不强制要求与源租户的 Unit 规格相同，允许使用更小的 Unit 规格。例如，创建一个 CPU 为 1 核且内存为 5 GB 的 Unit 规格 `unit1`。例如，

   ```sql
   CREATE RESOURCE UNIT unit1 MAX_CPU 1, MEMORY_SIZE = '5G';

   ```

   有关 Unit 规格的详细创建操作，请参见 [创建租户](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000218355)。
 3. 创建备租户所需的资源池。

   例如，创建资源池 `pool_for_standby`。

   ```sql
   CREATE RESOURCE POOL pool_for_standby UNIT = 'unit1', UNIT_NUM = 1, ZONE_LIST = ('zone1','zone2','zone3');

   ```

   有关资源池的详细创建操作，请参见 [创建租户](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000218355)。
 4. 从主租户的带有归档日志的完整数据集中恢复出备租户。

   假设获取到的数据备份放置在备租户可访问的路径 `file:///data/1/sh_databackup` 下，SQL 语句如下：

   ```sql
   ALTER SYSTEM RESTORE standby_tenant FROM 'file:///data/1/sh_databackup' WITH 'pool_list=pool_for_standby';

   ```
 5. 确认恢复是否完成。

   恢复过程中，可以通过 `DBA_OB_TENANTS` 视图确认恢复是否完成。

   ```sql
   SELECT TENANT_NAME, TENANT_TYPE, CREATE_TIME, STATUS, TENANT_ROLE,SCN_TO_TIMESTAMP(SYNC_SCN)  FROM oceanbase.DBA_OB_TENANTS WHERE TENANT_NAME = 'standby_tenant';

   ```

   查询结果如下：

   ```shell
   +----------------+-------------+----------------------------+--------+-------------+----------------------------+
   | TENANT_NAME    | TENANT_TYPE | CREATE_TIME                | STATUS | TENANT_ROLE | SCN_TO_TIMESTAMP(SYNC_SCN) |
   +----------------+-------------+----------------------------+--------+-------------+----------------------------+
   | standby_tenant | USER        | 2023-04-07 20:43:39.883628 | NORMAL | STANDBY     | 2023-04-07 20:05:16.617492 |
   +----------------+-------------+----------------------------+--------+-------------+----------------------------+
   1 row in set

   ```

   根据查询结果，当 `TENANT_ROLE` 的值为 `STANDBY` 时，则表示备租户恢复完成。

## 后续操作

#### 注意

不同于使用物理备份恢复（带日志）功能创建的备租户，通过该方式恢复出的备租户未指定日志恢复源，无法直接开启日志持续同步。需要设置日志恢复源后，才能开启日志的持续同步。

通过该方式创建的备租户，还需要进行如下操作：

1. [设置日志恢复源](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000220901)
 2. [设置日志恢复终点](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000220900)

## 相关文档

- [创建备租户前准备](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000218769)
 - [创建空备租户](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000218768)
 - [使用备份恢复（带日志）功能创建备租户](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000218770)
 - [设置日志恢复源](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000220901)
 - [设置日志恢复终点](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000220900)

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