大网数据广告活动
数据库部署与 SQL 参考

Apache Doris 中文参考:BACKUP

· 52CE 我爱测

该语句用于备份指定数据库下的数据。该命令为异步操作,提交成功后,需通过 命令查看进度。

描述

该语句用于备份指定数据库下的数据。该命令为异步操作,提交成功后,需通过 SHOW BACKUP 命令查看进度。

语法

BACKUP SNAPSHOT [<db_name>.]<snapshot_name>
TO `<repository_name>`
[ { ON | EXCLUDE } ]
    ( <table_name> [ PARTITION ( <partition_name> [, ...] ) ]
    [, ...] ) ]

[ PROPERTIES ( "<key>" = "<value>" [ , ... ] )]

必选参数

1.<db_name>

需要备份的数据所属的数据库名

2.<snapshot_name>

指定数据快照名。快照名不可重复,全局唯一

3.<repository_name>

仓库名。您可以通过 CREATE REPOSITORY 创建仓库

可选参数

1.<table_name>

需要备份的表名。如不指定则备份整个数据库。

  • ON 子句中标识需要备份的表和分区。如果不指定分区,则默认备份该表的所有分区
  • EXCLUDE 子句中标识不需要备份的表和分区。备份除了指定的表或分区之外这个数据库中所有表的所有分区数据。

2.<partition_name>

需要备份的分区名。如不指定则备份对应表的所有分区。

3.[ PROPERTIES ( "<key>" = "<value>" [ , ... ] ) ]

数据快照属性,格式为 <key> = <value>,目前支持以下属性:

  • "type" = "full":表示这是一次全量更新(默认)
  • "timeout" = "3600":任务超时时间,默认为一天。单位秒。

权限控制

执行此 SQL 命令的用户必须至少具有以下权限:

权限 对象 说明
LOAD_PRIV 用户(User)或 角色(Role) 用户或者角色拥有 LOAD_PRIV 权限才能进行此操作

注意事项:

  • 仅支持备份 OLAP 类型的表。
  • 同一数据库下只能有一个正在执行的 BACKUP 或 RESTORE 任务。
  • 备份操作会备份指定表或分区的基础表及 物化视图,并且仅备份一副本。异步物化视图还不支持。
  • 备份操作的效率取决于数据量、Compute Node 节点数量以及文件数量。备份数据分片所在的每个 Compute Node 都会参与备份操作的上传阶段。节点数量越多,上传的效率越高,文件数据量只涉及到的分片数,以及每个分片中文件的数量。如果分片非常多,或者分片内的小文件较多,都可能增加备份操作的时间。

示例

  1. 全量备份 example_db 下的表 example_tbl 到仓库 example_repo 中:
BACKUP SNAPSHOT example_db.snapshot_label1
TO example_repo
ON (example_tbl)
PROPERTIES ("type" = "full");
  1. 全量备份 example_db 下,表 example_tbl 的 p1, p2 分区,以及表 example_tbl2 到仓库 example_repo 中:
BACKUP SNAPSHOT example_db.snapshot_label2
TO example_repo
ON 
(
    example_tbl PARTITION (p1,p2),
    example_tbl2
);
  1. 全量备份 example_db 下除了表 example_tbl 的其他所有表到仓库 example_repo 中:
BACKUP SNAPSHOT example_db.snapshot_label3
TO example_repo
EXCLUDE (example_tbl);
  1. 全量备份 example_db 下的表到仓库 example_repo 中:
BACKUP SNAPSHOT example_db.snapshot_label3
TO example_repo;

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。