更新时间:2026-05-22 GMT+08:00
分享

创建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. 登录表格存储服务控制台
  1. 在集群管理界面,选择目标集群进入集群详情页面。
  2. 在左侧导航栏单击“备份恢复”,进入备份和恢复数据管理页面。
  3. 单击“备份恢复”页面左上角的“新建备份”,进入创建备份任务界面,配置表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

  4. 单击“确定”,创建备份任务。
  5. 备份任务创建后,会在“备份任务”列表中创建一个任务(详细信息介绍请参见表3),该任务会立即启动一个备份作业(可通过“查看所有任务”查看,详细信息介绍请参见表4),同时创建一份备份信息(详细信息介绍请参见表5)。

    如果需要对当前备份任务进行调整,可单击对应任务所在“操作”列的“编辑/复制”或“删除”,可修改任务相关的类型、名称等参数,删除任务时需要进行二次确认。

    图1 查看备份任务、备份信息列表
    图2 查看备份恢复任务列表

  6. 备份成功后,可单击“备份信息”区域该任务所在行的“立即加载”,获取备份的详细信息,其他参数介绍请参见表5

    图3 获取备份详细信息

备份任务及备份信息介绍

表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

操作

已创建的备份任务支持的操作。

  • 编辑(仅定时备份任务支持):单击“编辑”,可修改备份任务的名称等参数。
  • 复制(仅立即备份任务支持):单击“复制”,修改备份任务的类型、名称等参数后单击“确定”,会新创建一个备份任务。
  • 删除:可单击“删除”,根据实际需求勾选“删除该任务创建的备份文件”,并进行二次确认后删除备份任务。

    备份文件删除后无法恢复,请谨慎操作。

-

表4 任务列表信息介绍

参数

参数说明

示例

任务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

操作

可单击“取消”,中断备份恢复任务的执行。

-

表5 备份信息介绍

参数

参数说明

示例

备份名称/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

操作

已备份成功的数据支持的操作。

  • 恢复:可单击“恢复”,恢复已备份的数据,详细操作请参见创建StarRocks恢复任务
  • 删除:单击“删除”,可删除备份的数据。

-

相关文档