BACKUP | OceanBase 文档中心

BACKUP

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

描述

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

语法

配置数据备份目的端

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

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

发起全量数据备份

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

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

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

发起增量备份

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

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

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

停止备份

/* 系统租户停止集群中所有租户的数据备份任务 */
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。

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

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

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 租户发起全量数据备份。
```
obclient> ALTER SYSTEM BACKUP TENANT = mysql_tenant;
```

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

obclient> ALTER SYSTEM BACKUP INCREMENTAL TENANT = mysql_tenant;

系统租户仅停止 mysql_tenant 租户正在执行的数据备份任务。
```
obclient> ALTER SYSTEM CANCEL BACKUP TENANT = mysql_tenant;
```