---
title: "BACKUP - OceanBase 数据库 V4.3.1 | OceanBase 文档中心"
description: BACKUP ALTER SYSTEM BACKUP 语句用于发起数据备份。数据备份包括全量备份和增量备份。 全量备份备份的所有的宏块，增量备份是在上一个全量备份的基础上，备份所有新增和修改过的宏块。 使用限制及注意事项 发起数据备份前，需要保证已开启归档模式，并且归档任务的 STATUS 为 DOING 。 查看日…
---
切换语言

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

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

# BACKUP

更新时间：2026-04-10 11:58:01

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.3.1/zh-CN/700.reference/500.sql-reference/100.sql-syntax/100.system-tenants/200.alter-system/600.backup.md)  

`ALTER SYSTEM BACKUP` 语句用于发起数据备份。数据备份包括全量备份和增量备份。

全量备份备份的所有的宏块，增量备份是在上一个全量备份的基础上，备份所有新增和修改过的宏块。

## 使用限制及注意事项

- 发起数据备份前，需要保证已开启归档模式，并且归档任务的 `STATUS` 为 `DOING`。

  查看日志归档任务状态的相关操作，请参见 [查看归档进度](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000818797)。

  开启归档模式的相关语法，请参见 [ARCHIVELOG](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000821890)。
 - 执行增量数据备份需要确保已经有全量数据备份存在，如果在不存在全量数据备份的情况下直接发起增量备份，系统默认会将增量备份转换为全量备份。
 - 对于低版本集群升级到高版本（当前版本）集群的场景，即使当前租户在低版本中已经执行了全量备份，升级到高版本的集群中后，如果直接发起增量备份，系统默认也会将增量备份转换为全量备份。

## 权限要求

需要由 `sys` 租户的 `root` 用户（`root@sys`） 或各租户的管理员用户执行。其中：

- MySQL 模式的默认管理员用户为 `root` 用户。
 - Oracle 模式的默认管理员用户为 `SYS` 用户。

## 语法

```sql
ALTER SYSTEM backup_action [DESCRIPTION [=] 'desprition'];

backup_option:
      BACKUP DATABASE [PLUS ARCHIVELOG]
    | BACKUP TENANT [=] {tenant_name[, tenant_name]...} [PLUS ARCHIVELOG]
    | BACKUP INCREMENTAL DATABASE
    | BACKUP INCREMENTAL TENANT [=] {tenant_name[, tenant_name]...}

```

## 参数说明

| 参数 | 描述 |
| --- | --- |
| PLUS ARCHIVELOG | 在数据备份中添加 `PLUS ARCHIVELOG` 关键字后，可以在数据备份过程中同时将归档日志一起备份，最终备份目录下会生成一份带有归档日志的完整数据集。由于该数据集具备恢复能力，用户可以不依赖归档日志，使用该数据集将租户的数据恢复到 `MIN_RESTORE_SCN` 位点（备份集最新可恢复的 SCN）。 |
| tenant_name | 系统租户指定待备份的租户名。支持同时指定多个租户名，不同租户名之间使用英文逗号（,）分隔。如果需要指定所有用户租户，需要在系统租户下执行 `ALTER SYSTEM BACKUP [INCREMENTAL] DATABASE` 语句。   #### 注意    仅系统租户在执行此命令时可以通过 `TENANT = tenant_name` 子句指定待操作的租户，用户租户只能对本租户执行此命令，故不能指定 `TENANT = tenant_name` 子句。 |
| INCREMENTAL | 表示增量备份。 |
| desprition | 指定该操作的描述信息，可选。 |

## 示例

假设当前集群中有 3 个租户，分别是 `sys`、`mysql_tenant` 和 `oracle_tenant`，且租户 `mysql_tenant` 和 `oracle_tenant` 均已完成发起数据备份前的准备工作。

- 系统租户

     - 系统租户对集群中的所有用户租户发起全量数据备份。

      ```sql
      obclient [oceanbase]> ALTER SYSTEM BACKUP DATABASE;

      ```

      语句执行后，系统会对集群中的 `mysql_tenant` 租户和 `oracle_tenant` 租户发起全量数据备份。
     - 系统租户对租户 `mysql_tenant` 发起全量数据备份。

      ```sql
      obclient [oceanbase]> ALTER SYSTEM BACKUP TENANT = mysql_tenant;

      ```
     - 系统租户对租户 `mysql_tenant` 发起带归档日志的全量数据备份，

      ```sql
      obclient [oceanbase]> ALTER SYSTEM BACKUP TENANT = mysql_tenant PLUS ARCHIVELOG;

      ```

      语句执行后，系统会在该租户的数据备份路径下生成一份带有归档日志的完整数据集。对于社区版用户和单机版用户，在物理备库场景下，可以使用该数据集创建出备租户，有关如何使用带归档日志的完整数据集创建备租户的详细操作，请参见 [使用 BACKUP DATABASE PLUS ARCHIVELOG 功能创建备租户](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000819150)。
     - 系统租户对集群中的所有租户发起增量数据备份。

      ```sql
      obclient [oceanbase]> ALTER SYSTEM BACKUP INCREMENTAL DATABASE;

      ```

      本示例中，语句执行后，系统会对集群中的 `mysql_tenant` 租户和 `oracle_tenant` 租户发起增量数据备份。
     - 系统租户对租户 `mysql_tenant` 发起增量数据备份。

      ```sql
      obclient [oceanbase]> ALTER SYSTEM BACKUP INCREMENTAL TENANT = mysql_tenant;

      ```
 - 用户租户

     - 租户 `mysql_tenant` 对本租户发起全量数据备份。

      ```
     - 租户 `oracle_tenant` 对本租户发起带归档日志的全量数据备份。

      ```sql
      obclient [SYS]> ALTER SYSTEM BACKUP DATABASE PLUS ARCHIVELOG;

      ```
     - 租户 `mysql_tenant` 对本租户发起增量数据备份。

      ```

## 相关文档

- [ARCHIVELOG](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000821890)
 - [使用 BACKUP DATABASE PLUS ARCHIVELOG 功能创建备租户](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000819150)

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