文档首页/ 表格存储服务 CloudTable/ 用户指南/ 使用StarRocks/ StarRocks集群运维/ 修改StarRocks参数配置对集群进行性能调优
更新时间：2026-01-06 GMT+08:00
查看PDF
分享

修改StarRocks参数配置对集群进行性能调优

创建完StarRocks集群后，用户可以在表格存储服务控制台中多次修改集群的StarRocks配置参数，对集群的性能进行调优。

使用限制

  • 修改集群静态参数需要重启集群，可能会导致业务的中断。
  • 集群无运行中的任务时，才能修改参数。
  • CloudTable StarRocks集群重启过程中，不允许修改集群参数。

StarRocks修改参数步骤

  1. 登录表格存储服务控制台。
  2. 左上角选择区域。
  3. 在左侧导航栏中，单击“集群管理”。
  4. 在集群列表中找到所需要的集群，单击集群名称，进入“参数配置”页面。
  5. 在“参数配置”中单击“参数配置”页签，对StarRocks参数进行修改。
  6. 选择修改的节点（FE、BE节点）后，选中需要修改的参数，在“参数值”列单击。
  7. 在修改框中输入新值，单击，系统提示“参数修改为' xx '成功，请保存本次修改值”，并且修改的参数值后显示红色*。

    如果单击，则取消修改。

    图1 修改参数

  8. 单击参数列表左上方的“保存修改”，弹出“保存修改”对话框。
  9. 在“保存修改”对话框中，确认参数修改信息正确后，然后单击“确定”。

    图2 保存修改
    • 单击确定后，再单击右上角的刷新按钮，如果参数表状态显示“已生效”，集群不用重启。如果显示“未生效”，用户需要手动重启集群才能使修改的参数生效。
    • 单击参数配置页签左上角的重启按钮，集群重启或者返回集群列表页面重启集群。
      静态参数修改完成后，需要手动重启集群，参数才能生效。动态参数修改后生效，不用重启集群。
      图3 重启
    • 如果修改的参数值不正确，可以在“保存修改”对话框中单击“一键还原”，取消修改参数值。

  10. 参数修改完成后，可以单击“修改历史”页签查看参数修改的历史。“修改历史”页面中显示如下信息。

    表1 参数说明

    参数

    参数说明

    参数名

    被修改过的参数名。

    旧值

    修改前的参数值。

    新值

    修改后的参数值。

    修改时间

    记录用户修改参数值的时间。

StarRocks参数修改状态

表2 状态

状态

状态说明

未更改

StarRocks未更改的参数。

未应用

StarRocks参数已修改但是未应用。

未生效

StarRocks静态参数，修改保存后需要重启集群。

已生效

StarRocks参数修改后已生效：

  • 静态参数修改保存后，集群需要重启才能生效。
  • 动态参数修改保存后生效。

FE节点参数说明

表3 FE节点参数说明

参数名

静态参数

参数描述

dynamic_partition_enable

否
  • 参数类型：boolean
  • 参数范围：[true，false]
  • 参数默认值：true
  • 描述：是否开启StarRocks的动态分区功能。该参数只影响动态分区表的分区操作，不影响普通表。

dynamic_partition_check_interval_seconds

否
  • 参数类型：long
  • 参数范围：(0,9223372036854775807)
  • 参数默认值：600
  • 单位：s
  • 描述：动态分区线程的执行频率，默认为600（10分钟），即每10分钟进行一次调度。

max_routine_load_task_num_per_be

否
  • 参数类型：int
  • 参数范围：(0,300)
  • 参数默认值：16
  • 描述：该参数限制每个BE并发执行的Routine Load导入作业的数量上限。超过后，不能再提交新的作业。

max_routine_load_task_concurrent_num

否
  • 参数类型：int
  • 参数范围：(0,10)
  • 参数默认值：5
  • 描述：该参数限制了一个Routine Load导入作业最大的子任务并发数，建议维持默认值。设置过大，可能导致同时并发的任务数过多，占用集群资源。

max_broker_load_job_concurrency

否
  • 参数类型：int
  • 参数范围：(0,30)
  • 参数默认值：5
  • 描述：Broker Load导入作业的最大并发数。

min_bytes_per_broker_scanner

否
  • 参数类型：long
  • 参数范围：(0,9223372036854775807)
  • 参数默认值：67108864
  • 单位：byte
  • 描述：单个Broker Load实例处理的最小数据量。

max_automatic_partition_number

否
  • 参数类型：int
  • 参数范围：(0,2147483647)
  • 参数默认值：4096
  • 描述：系统自动创建分区数量上限。该参数可以防止您由于误操作而创建大量分区。

tablet_sched_repair_delay_factor_second

否
  • 参数类型：long
  • 参数范围：(0,2147483647)
  • 参数默认值：60
  • 描述：FE进行副本修复的间隔。此参数为一个基准系数。对于HIGH优先级，延迟为基准系数 * 1；对于NORMAL优先级，延迟为基准系数 * 2；对于LOW优先级，延迟为基准系数 * 3。即优先级越低，延迟等待时间越长。如果用户想尽快修复副本，可以适当降低该参数。

tablet_sched_balance_load_score_threshold

否
  • 参数类型：double
  • 参数范围：(0,1)
  • 参数默认值：0.1
  • 描述：集群balance百分比的阈值。默认为0.1，即10%。当一个BE节点的load score，不高于或不低于平均load score的10% 时，我们认为这个节点是均衡的。如果想让集群负载更加平均，可以适当调低这个参数

BE节点参数说明

表4 BE节点参数说明

参数名

静态参数

参数描述

max_consumer_num_per_grou

是
  • 参数类型：int
  • 参数范围：（0，10）
  • 参数默认值：3
  • 描述：一个数据消费者组中的最大消费者数量，用于routine load。

clone_worker_count

是
  • 参数类型：int
  • 参数范围：（0，10）
  • 参数默认值：3
  • 描述：用于执行克隆任务的线程数，其值影响副本均衡的速度。在磁盘压力不大的情况下，可以通过调整该参数来加快副本均衡。
父主题： StarRocks集群运维

相关文档