跳到主要内容
版本:Latest-3.3

部署后设置

本文描述了您在部署 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 集群在生产环境中正常工作,您需要设置以下系统变量:

变量名StarRocks 版本推荐值说明
is_report_successv2.4 或更早false是否发送查询 Profile 以供分析。默认值为 false,即不发送。将此变量设置为 true 会影响 StarRocks 的并发性能。
enable_profilev2.5 或以后false是否发送查询 Profile 以供分析。默认值为 false,即不发送。将此变量设置为 true 会影响 StarRocks 的并发性能。
enable_pipeline_enginev2.3 或以后true是否启用 Pipeline Engine。true 表示启用,false 表示禁用。默认值为 true.
parallel_fragment_exec_instance_numv2.3 或以后如果您启用了 Pipeline Engine,您可以将此变量设置为1。如果您未启用 Pipeline Engine,您可以将此变量设置为 CPU 核数的一半。每个 BE 上用于扫描节点的实例数。默认值为 1
pipeline_dopv2.3、v2.4 及 v2.50Pipeline 实例的并行度,用于调整查询并发度。默认值:0,表示系统自动调整每个 Pipeline 实例的并行度。
自 v3.0 起,StarRocks 根据查询并行度自适应调整该参数。
  • 全局设置 is_report_successfalse

    SET GLOBAL is_report_success = false;
  • 全局设置 enable_profilefalse

    SET GLOBAL enable_profile = false;
  • 全局设置 enable_pipeline_enginetrue

    SET GLOBAL enable_pipeline_engine = true;
  • 全局设置 parallel_fragment_exec_instance_num1

    SET GLOBAL parallel_fragment_exec_instance_num = 1;
  • 全局设置 pipeline_dop0

    SET GLOBAL pipeline_dop = 0;

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

设置用户属性

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

-- 将 <username> 替换为需要增加最大连接数的用户名。
SET PROPERTY FOR '<username>' 'max_user_connections' = '1000';

下一步

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