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

部署后设置

· 52CE 我爱测

在将新的 StarRocks 集群投入生产之前,您必须管理初始帐户并设置必要的变量和属性以使集群正常运行。

部署后设置

本文描述了您在部署 StarRocks 之后需要执行的任务。

在将新的 StarRocks 集群投入生产之前,您必须管理初始帐户并设置必要的变量和属性以使集群正常运行。

管理初始帐户

创建 StarRocks 集群后,系统会自动生成集群的初始 root 用户。root 用户拥有 root 权限,即集群内所有权限的集合。我们建议您修改 root 用户密码并避免在生产中使用该用户,以避免误用。

  1. 使用用户名 root 和空密码通过 MySQL 客户端连接到 StarRocks。

    # 将 <fe_address> 替换为您连接的 FE 节点的 IP 地址(priority_networks)
    # 或 FQDN,将 <query_port> 替换为您在 fe.conf 中指定的 query_port(默认:9030)。
    mysql -h <fe_address> -P<query_port> -uroot
    
  2. 执行以下 SQL 重置 root 用户密码:

    -- 将 <password> 替换为您要为 root 用户设置的密码。
    SET PASSWORD = PASSWORD('<password>')
    

说明

  • 重置密码后请务必妥善保管。如果您忘记了密码,请参阅 重置丢失的 root 密码 了解详细说明。
  • 完成部署后设置后,您可以创建新用户和角色来管理团队内的权限。有关详细说明,请参阅 管理用户权限。

设置必要的系统变量

为使您的 StarRocks 集群在生产环境中正常工作,您需要设置以下系统变量:

enable_profile

StarRocks Version: v2.5 或以后
推荐值: false
推荐值: 是否发送查询 Profile 以供分析。默认值为 false,即不发送。将此变量设置为 true 会影响 StarRocks 的并发性能。

  • 全局设置 enable_profile 为 false:

    SET GLOBAL enable_profile = false;
    

enable_pipeline_engine

StarRocks Version: v2.3 或以后
推荐值: true
推荐值: 是否启用 Pipeline Engine。true 表示启用,false 表示禁用。默认值为 true.

  • 全局设置 enable_pipeline_engine 为 true:

    SET GLOBAL enable_pipeline_engine = true;
    

parallel_fragment_exec_instance_num

StarRocks Version: v2.3 或以后
推荐值: 如果您启用了 Pipeline Engine,您可以将此变量设置为1。如果您未启用 Pipeline Engine,您可以将此变量设置为 CPU 核数的一半。
推荐值: 每个 BE 上用于扫描节点的实例数。默认值为 1。

  • 全局设置 parallel_fragment_exec_instance_num 为 1:

    SET GLOBAL parallel_fragment_exec_instance_num = 1;
    

有关系统变量的更多信息,请参阅 系统变量。

设置用户属性

如果您在集群中创建了新用户,则需要增加新用户的最大连接数(例如至 1000):

-- 将 <username> 替换为需要增加最大连接数的用户名。
ALTER USER '<username>' SET PROPERTIES ("max_user_connections" = "1000");

下一步

成功部署和设置 StarRocks 集群后,您可以开始着手设计最适合您的业务场景场景的表。有关表设计的详细说明,请参阅 理解表设计。

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

资料来源与适用范围

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

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

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