--- title: "使用备份恢复（带日志）功能创建备租户 - OceanBase 数据库 V4.3.5 | OceanBase 文档中心" description: 使用备份恢复（带日志）功能创建备租户 使用备份恢复（带日志）功能创建备租户的方式为一种通用方式，该方式主要是从数据备份和日志归档中恢复出备租户，并且既可以从主租户的数据备份和日志归档中恢复，也可以从已存在的备租户的数据备份和日志归档中恢复。 步骤一：主租户或其他的备租户开启归档模式并执行数据备份 由于新的备租户需要从… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.3.5 LTS # 使用备份恢复（带日志）功能创建备租户 更新时间：2026-04-07 20:57:20 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.3.5/zh-CN/600.manage/400.high-availability/300.physical-standby-database-disaster-recovery/200.create-a-standby-tenant/300.create-a-standby-tenant-by-backup-and-recovery.md) 使用备份恢复（带日志）功能创建备租户的方式为一种通用方式，该方式主要是从数据备份和日志归档中恢复出备租户，并且既可以从主租户的数据备份和日志归档中恢复，也可以从已存在的备租户的数据备份和日志归档中恢复。 ## 步骤一：主租户或其他的备租户开启归档模式并执行数据备份 由于新的备租户需要从数据备份和日志归档中恢复出来，故在新建备租户前，需要为主租户或源端的备租户开启归档模式并执行一次全量数据备份。 #### 说明 设置归档目的端、开启归档模式、设置备份目的端以及执行数据备份等操作均支持在系统租户（`sys` 租户）或用户租户下执行，在系统租户下执行时，需要在对应命令的结尾加 `tenant = 'tenant_name'`，本文以在用户租户下的操作为例，提供操作指导。 1. 主租户或源端的备租户开启归档模式，并保证归档状态一直为 `DOING`。 1. 设置归档目的端。 假设归档介质使用 NFS，归档目的端路径为 `/data/1/sh_archive/`，用户租户设置归档目的端的 SQL 语句示例如下： ```sql ALTER SYSTEM SET LOG_ARCHIVE_DEST = 'LOCATION=file:///data/1/sh_archive'; ``` 设置归档目的端的详细操作，请参见 [日志归档前准备](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002013175)。 2. 开启主租户或源端的备租户的归档模式。 #### 注意 为了保证数据备份期间的日志都能被归档，必须先开启租户的归档模式后，再执行数据备份。 用户租户开启归档模式的 SQL 语句如下： ```sql ALTER SYSTEM ARCHIVELOG; ``` 开启归档模式的详细操作，请参见 [开启归档模式](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002013179)。 3. 确认归档状态是否为 `DOING`。 用户租户查询归档状态的语句如下，如果是系统租户，需要查询 `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 | 1680265982125159110 | 2023-03-31 20:33:02.125159 | file:///data/1/sh_archive | +---------+----------+---------+--------+---------------------+----------------------------+--------------------------------+ 1 row in set ``` 根据查询结果，`STATUS` 的值为 `DOING`，表示归档处于正常工作状态。 查看归档状态的详细操作，请参见 [查看归档进度](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002013174)。 2. 主租户或源端的备租户开启数据备份，并完成一次全量备份。 开启归档模式后，主租户或源端的备租户需要执行一次数据备份。 1. 设置数据备份的备份目的端。 假设备份介质使用 NFS，备份目的端路径为 `/data/1/sh_databackup`，用户租户设置备份目的端的 SQL 语句示例如下： ```sql ALTER SYSTEM SET DATA_BACKUP_DEST = 'file:///data/1/sh_databackup'; ``` 设置备份目的端的详细操作，请参见 [备份前准备](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002013190)。 2. 执行数据备份。 用户租户执行数据备份的 SQL 语句如下： ```sql ALTER SYSTEM BACKUP DATABASE; ``` 发起租户全量数据备份的详细操作，请参见 [发起数据备份](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002013186)。 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-1000000002013195)。 如果备份已完成，可以通过 `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 | OFF | FULL | USER_TENANT | NONE | | 2023-03-31 20:48:32.342315 | 2023-03-31 20:49:39.908559 | COMPLETED | 0 | | | file:///data/1/sh_databackup | +--------+-------------+---------------+---------------------+------------------+--------------------+-----------------+-------------+-------------+-----------------+--------+----------------------------+----------------------------+-----------+--------+---------+-------------+-------------------------------+ 1 row in set ``` 根据查询结果，当 `STATUS` 的值为 `COMPLETED` 时，表示数据备份已完成。 ## 步骤二：恢复出备租户 1. 使用 `root` 用户登录到待创建的备租户所在集群的 `sys` 租户。 2. 执行以下命令，创建备租户所需的 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-1000000002013128)。 3. 创建备租户所需的资源池。 为备租户创建资源池时，建议尽量与源端租户保持同构，即建议备租户的资源池中 `unit_num` 的个数与源端租户相同。 例如，创建资源池 `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-1000000002013128)。 4. 执行 `RESTORE` 命令，使用租户的数据备份和日志归档功能，恢复出备租户。 语句如下： ```sql ALTER SYSTEM RESTORE standby_tenant_name FROM uri UNTIL TIME ='timestamp' WITH 'restore_option' [WITH KEY FROM 'backup_key_path' ENCRYPTED BY 'password'] [DESCRIPTION description]; ``` 相关参数说明如下： - `standby_tenant_name`：指待恢复出的备租户的名称。 - `uri`：需要分别指定主租户或源端的备租户的数据备份路径和归档路径。 - `UNTIL TIME= timestamp`：用于指定的恢复终点，恢复到该位点为止，且包括该位点。指定 `timestamp` 必须以 `=` 连接。`timestamp` 仅支持 `YYYY-MM-DD HH24:MI:SS.FF` 格式, 精确到纳秒。 关于如何选取 `timestamp` 的详细说明，请参见 [物理恢复相关参数介绍](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002013165)。 - `restore_option` 支持指定 `pool_list`、`locality`、`primary_zone`, 其中 `pool_list` 为必选项, 其余为可选项。不同参数之间通过 `&` 分隔。在指定 `locality` 和 `primary_zone` 时，建议尽量与源租户保持同构。如果不同构，待租户恢复后激活为主租户可能会产生负载均衡操作，影响性能。 有关 `restore_option` 中各参数的详细说明，请参见 [物理恢复相关参数介绍](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002013165)。 - `WITH KEY FROM 'backup_key_path' ENCRYPTED BY 'password'`：指定加密租户的秘钥备份信息。仅当源租户配置了透明加密，才需要在恢复时指定秘钥备份相关的信息。 - `backup_key_path`：秘钥的备份路径。 - `password`：备份秘钥时设置的加密密码。 从日志归档路径 `file:///data/1/sh_archive` 与数据备份路径 `file:///data/1/sh_databackup` 恢复出备租户 `standby_tenant` 的示例如下： ```sql ALTER SYSTEM RESTORE standby_tenant FROM 'file:///data/1/sh_databackup,file:///data/1/sh_archive' UNTIL TIME='2023-05-26 15:04:23.825558' WITH 'pool_list=pool_for_standby'; ``` 关于 `RESTORE` 命令的更多介绍，请参见 [物理恢复相关参数介绍](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002013165)。 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-02 20:42:38.800518 | NORMAL | STANDBY | 2023-04-02 20:42:30.736135 | +----------------+-------------+----------------------------+--------+-------------+----------------------------+ 1 row in set ``` 根据查询结果，当 `TENANT_ROLE` 的值为 `STANDBY` 时，则表示备租户恢复完成。 有关查看恢复进度的更多详细介绍，请参见 [查看恢复进度](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002013166)。 ## 步骤三：开启日志持续同步 使用默认的 `RESTORE` 命令创建的新备租户，不会连续同步主租户或源端备租户归档的日志，需要手动再执行 `RECOVER` 命令重新设置新备租户的恢复终点，开启日志持续同步模式。 1. 使用管理员用户登录新备租户或新备租户所在集群的 `sys` 租户。 2. 根据实际使用场景，执行 `RECOVER` 命令，更改新备租户的恢复终点。 - 新备租户所在集群的 `sys` 租户为新备租户开启日志持续同步 ```sql ALTER SYSTEM RECOVER STANDBY TENANT = tenant_name UNTIL UNLIMITED; ``` 其中，`UNLIMITED` 表示无穷大。 示例如下： ```sql ALTER SYSTEM RECOVER STANDBY TENANT = standby_tenant UNTIL UNLIMITED; ``` - 新备租户为本租户开启日志持续同步 ```sql ALTER SYSTEM RECOVER STANDBY UNTIL UNLIMITED; ``` 3. 再次查询 `DBA_OB_TENANTS` 视图，通过 `SYNC_SCN` 字段确认新备租户的同步位点。 其中，`SCN_TO_TIMESTAMP(SYNC_SCN)` 列显示了新备租户当前的同步进度。 - 新备租户所在集群的 `sys` 租户查询视图 ``` - 新备租户查询视图 - MySQL 租户 ``` 查询结果如下： ```shell +----------------+-------------+----------------------------+--------+-------------+----------------------------+ | TENANT_NAME | TENANT_TYPE | CREATE_TIME | STATUS | TENANT_ROLE | SCN_TO_TIMESTAMP(SYNC_SCN) | +----------------+-------------+----------------------------+--------+-------------+----------------------------+ | standby_tenant | USER | 2023-04-02 20:42:38.800518 | NORMAL | STANDBY | 2023-04-02 21:06:50.810688 | +----------------+-------------+----------------------------+--------+-------------+----------------------------+ 1 row in set ```sql SELECT TENANT_NAME, TENANT_TYPE, CREATE_TIME, STATUS, TENANT_ROLE,SCN_TO_TIMESTAMP(SYNC_SCN) FROM SYS.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 | 23-MAY-23 02.37.58.647507 PM | NORMAL | STANDBY | 26-MAY-23 01.34.46.896905660 PM | +------------------+-------------+------------------------------+--------+-------------+---------------------------------+ 1 row in set ``` ## 相关文档 - [创建备租户前准备](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002013558) - [创建空备租户](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002013557) - [使用 BACKUP DATABASE PLUS ARCHIVELOG 功能创建备租户](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002013556) - [设置日志恢复源](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002016126) 上一篇 下一篇 ![有帮助](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) 咨询热线