---
title: github-fill
description: "BACKUP 描述 该语句用来配置数据备份目的端、发起全量数据备份、发起增量备份和取消备份。系统租户和用户租户都可以执行数据备份相关操作。 语法 配置数据备份目的端 /* 系统租户为指定租户（不包含 sys 租户本身）配置备份目的端 */ ALTER SYSTEM SET DATA_BACKUP_DEST = 'da…"
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

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

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

# BACKUP

更新时间：2026-06-10 10:38:24

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

## 描述

该语句用来配置数据备份目的端、发起全量数据备份、发起增量备份和取消备份。系统租户和用户租户都可以执行数据备份相关操作。

## 语法

### 配置数据备份目的端

```sql
/* 系统租户为指定租户（不包含 sys 租户本身）配置备份目的端 */
ALTER SYSTEM SET DATA_BACKUP_DEST = 'data_backup_path' TENANT = tenant_name;

/* 用户租户配置本租户的备份目的端 */
ALTER SYSTEM SET DATA_BACKUP_DEST = 'data_backup_path';

```

### 发起全量数据备份

```sql
/* 系统租户对集群中的所有租户发起全量数据备份 */
ALTER SYSTEM BACKUP DATABASE;

/* 系统租户对集群中的指定租户发起全量数据备份 */
ALTER SYSTEM BACKUP TENANT [=] tenant_name;

/* 用户租户对本租户发起全量数据备份 */
ALTER SYSTEM BACKUP DATABASE;

```

### 发起增量备份

```sql
/* 系统租户对集群中的所有租户发起增量数据备份 */
ALTER SYSTEM BACKUP INCREMENTAL DATABASE;

/* 系统租户对集群中的所有租户发起增量数据备份 */
ALTER SYSTEM BACKUP INCREMENTAL TENANT = tenant_name;

/* 用户租户对本租户发起增量数据备份 */
ALTER SYSTEM BACKUP INCREMENTAL DATABASE;

```

### 停止备份

```sql
/* 系统租户停止集群中所有租户的数据备份任务 */
ALTER SYSTEM CANCEL BACKUP;

/* 系统租户停止集群中指定租户的数据备份任务 */
ALTER SYSTEM CANCEL BACKUP TENANT = tenant_name;

/* 用户租户停止本租户正在执行的数据备份任务 */
ALTER SYSTEM CANCEL BACKUP;

```

## 语法说明

| 字段 | 说明 |
| --- | --- |
| DATA_BACKUP_DEST | 配置数据备份的目的端。 |
| data_backup_path | 指定备份目的端。 |
| 目前 OceanBase 数据库支持的备份目的端介质为 NFS 和阿里云 OSS。 |
| tenant_name | 指定租户名称。 |
| INCREMENTAL | 增量备份。 |

## 示例

- 系统租户仅为租户 `mysql_tenant` 配置备份目的端，备份介质为 NFS。

  ```shell
  obclient> ALTER SYSTEM SET DATA_BACKUP_DEST = 'file:///data/nfs/backup/data' TENANT = mysql_tenant;

  ```
 - 系统租户仅为租户 `mysql_tenant`配置备份目的端，归档目的端的介质为 OSS 并配置归档文件的清理模式。

  ```shell
  obclient> ALTER SYSTEM SET DATA_BACKUP_DEST = 'oss://oceanbase-test-bucket/backup/?host=xxx.aliyun-inc.com&access_id=xxx&access_key=xxx&delete_mode=delete' TENANT = mysql_tenant;

  ```
 - 系统租户仅对 `mysql_tenant` 租户发起全量数据备份。

  ```shell
  obclient> ALTER SYSTEM BACKUP TENANT = mysql_tenant;

  ```
 - 系统租户仅对 `mysql_tenant` 租户发起增量数据备份。

  ```shell
  obclient> ALTER SYSTEM BACKUP INCREMENTAL TENANT = mysql_tenant;

  ```
 - 系统租户仅停止 `mysql_tenant` 租户正在执行的数据备份任务。

  ```shell
  obclient> ALTER SYSTEM CANCEL BACKUP TENANT = mysql_tenant;

  ```

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