创建StarRocks备份任务
用户可以在CloudTable StarRocks集群的备份恢复界面创建数据备份任务,系统会将备份任务中的库表备份至OBS中。
约束与限制
- 备份操作会占用系统资源,包括CPU、内存、磁盘I/O和网络带宽,因此会对集群的读写性能产生影响。建议在业务低峰期或运维时间段启动备份任务,业务高峰期执行容易导致生产业务受损。
如果希望在业务高峰期时间段执行备份任务,需在运行任务前执行以下SQL命令降低备份任务对资源的占用:
UPDATE information_schema.be_configs SET VALUE = '2' WHERE NAME = 'upload_worker_count';
upload_worker_count表示BE节点在备份任务中允许的最大上传线程数,默认值为“0”,自动设置为BE所在机器的CPU核数。调低该值可有效减少并发资源消耗。
- 仅支持备份default_catalog下的数据库和表。
- 不支持备份External Catalog、逻辑视图(View)、用户、权限等对象数据。
- 由于数据备份是通过快照生成的,因此在快照生成后写入的数据将不再包含在已提交的备份操作中。
- 单个备份任务最多支持备份2000个数据库,且单个数据库中的表不超过5000个。
创建StarRocks备份任务
- 登录表格存储服务控制台。
- 在集群管理界面,选择目标集群进入集群详情页面。
- 在左侧导航栏单击“备份恢复”,进入备份和恢复数据管理页面。
- 单击“备份恢复”页面左上角的“新建备份”,进入创建备份任务界面,配置表1或表2中的相关参数。
表1 创建立即备份任务 参数
参数说明
示例
备份类型
备份任务的类型,即“立即备份”。
立即备份
任务名称
备份任务名称,不超过128个字符。
backup-name
任务描述
备份任务说明(可为空)。
-
数据库和表
勾选“集群”或需要备份的数据库和表,也可在搜索框中搜索后再勾选。
- 仅支持默认Catalog库表备份。
- 不支持备份外表,且也不会显示。
- 勾选“集群”会备份当前集群下所有支持备份的数据库。
- 勾选数据库会备份当前数据库下所有支持备份的表。
- 选中表进行备份时,需确保表存在,否则备份将失败;包含临时分区的表不支持备份操作。
test_db.users
表2 创建定时备份任务 参数
参数说明
示例
备份类型
备份任务的类型,即“定时备份”。
定时备份
任务名称
备份任务名称,不超过128个字符。
定时备份任务
任务描述
备份任务说明(可为空)。
-
备份保留数量
保留的备份副本数,取值为1~100。
1
备份周期频率
每隔多少天执行一次,取值为1~365,单位为天。
2
备份开始时间
任务开始执行的时间,会比设定的时间晚0~10 分钟执行。
2026/04/07 10:18:28
任务是否开启
是否启用该定时任务。
开启
数据库和表
勾选“集群”或需要备份的数据库和表,也可在搜索框中搜索后再勾选。
- 仅支持默认Catalog库表备份。
- 不支持备份外表,且也不会显示。
- 勾选“集群”会备份当前集群下所有支持备份的数据库。
- 勾选数据库会备份当前数据库下所有支持备份的表。
- 选中表进行备份时,需确保表存在,否则备份将失败;包含临时分区的表不支持备份操作。
test_db1.users
- 单击“确定”,创建备份任务。
- 备份任务创建后,会在“备份任务”列表中创建一个任务(详细信息介绍请参见表3),该任务会立即启动一个备份作业(可通过“查看所有任务”查看,详细信息介绍请参见表4),同时创建一份备份信息(详细信息介绍请参见表5)。
如果需要对当前备份任务进行调整,可单击对应任务所在“操作”列的“编辑/复制”或“删除”,可修改任务相关的类型、名称等参数,删除任务时需要进行二次确认。
图1 查看备份任务、备份信息列表
图2 查看备份恢复任务列表
- 备份成功后,可单击“备份信息”区域该任务所在行的“立即加载”,获取备份的详细信息,其他参数介绍请参见表5。 图3 获取备份详细信息
备份任务及备份信息介绍
| 参数 | 参数说明 | 示例 |
|---|---|---|
| 任务名称/ID | 备份任务的名称及任务ID。 | 示例备份 af38d026-9d61-40e3-85c6-4142a4b8673e |
| 备份类型 | 数据的备份类型,包括“立即备份”和“定时备份”。 | 立即备份 |
| 状态 | 备份任务的状态(仅备份类型为“定时备份”时会显示)。
| 服务中 |
| 备份范围 | 数据备份范围。
| 集群 |
| 备份对象 | 创建备份任务时指定备份的数据库、表。 | - |
| 最近任务 | 关联的最新备份任务信息,可单击任务ID跳转到任务列表中查看任务相关信息。 | - |
| (已备份/保留)数量 | 已备份数量与备份保留的上限数量。 | 1/1 |
| 任务描述 | 备份任务的描述信息。 | - |
| 创建时间 | 创建备份任务的时间。 | 2026/04/02 11:49:21 GMT+08:00 |
| 更新时间 | 备份任务的更新时间。 | 2026/04/07 07:29:28 GMT+08:00 |
| 操作 | 已创建的备份任务支持的操作。 | - |
| 参数 | 参数说明 | 示例 |
|---|---|---|
| 任务ID | 正在运行的备份恢复任务ID。 | e08cebbf-9004-423b-b306-4b663c8922bc |
| 备份名称/ID | 备份信息名称以及备份信息ID。 | 示例备份 aa9d717e-c67f-4212-85e1-8d6f6cc998b5 |
| 任务类型 | 任务的类型,包括“备份”和“恢复” | 备份 |
| 目标集群 | 备份数据来源集群或恢复数据的目标集群。 | cloudtable-test |
| 任务状态 | 任务的运行状态
| 完成 |
| 备份恢复对象 | 单击“点击加载”,可查看备份或恢复的对象信息。 | 数据库: db; |
| 定时任务ID | 备份任务的ID。 | af38d026-9d61-40e3-85c6-4142a4b8673e |
| 创建时间 | 任务的创建时间。 | 2026/04/02 11:57:34 GMT+08:00 |
| 结束时间 | 任务运行完成的时间。 | 2026/04/02 11:59:38 GMT+08:00 |
| 操作 | 可单击“取消”,中断备份恢复任务的执行。 | - |
| 参数 | 参数说明 | 示例 |
|---|---|---|
| 备份名称/ID | 备份的名称及备份ID。 | 示例备份 aa9d717e-c67f-4212-85e1-8d6f6cc998b5 |
| 备份状态 | 备份任务的状态。
| 可用 |
| 备份对象 | 单击“点击加载”,可查看备份的数据库、表信息。 | 数据库: db; 表: db.orders_agg |
| 任务ID | 创建该备份的任务ID。 | e08cebbf-9004-423b-b306-4b663c8922bc |
| 备份大小 | 备份文件在OBS中所占用的大小。 | 27 KB |
| 备份来源 | 创建该备份的任务类型,包括“手动备份”和“定时备份”。 | 手动备份 |
| 描述 | 备份任务的描述信息。 | - |
| 创建时间 | 创建备份任务的时间。 | 2026/04/02 11:49:21 GMT+08:00 |
| 操作 | 已备份成功的数据支持的操作。
| - |