第1.3章：StarRocks部署--单机快速验证指南

1. 单机部署StarRocks的必要性与适用场景

当你第一次听说StarRocks这个MPP数据库时，可能会被它强大的分析性能所吸引。但随之而来的问题是：如何在资源有限的环境下快速体验它的核心功能？这就是单机部署的价值所在。虽然官方文档中明确表示StarRocks没有所谓的"Standalone模式"，但在实际工作中，我们经常遇到需要在单台机器上快速验证功能的场景。

想象一下这样的情形：你正在评估一个数据分析项目，手头只有一台开发机；或者你需要向团队演示StarRocks的基本功能，但来不及申请多台服务器资源。在这些情况下，单机部署就成了最实用的解决方案。我曾在客户现场遇到过类似情况，当时用一台16核32GB内存的笔记本就完成了整个POC演示，效果出奇地好。

单机部署的核心思路是：在一台机器上同时运行FE（Frontend）、BE（Backend）和Broker三个服务。FE负责元数据管理和查询协调，BE处理数据存储和计算，Broker则用于与外部存储系统交互。这种部署方式虽然不适合生产环境，但足以让你体验StarRocks 80%的核心功能，包括建表、导入数据和执行复杂查询。

2. 环境准备与部署规划

2.1 硬件与软件需求

在开始部署前，我们需要确保机器满足基本要求。根据我的经验，即使是测试环境，也建议配置至少4核CPU和8GB内存。我曾尝试在2核4GB的机器上部署，结果BE服务频繁OOM，体验非常糟糕。磁盘方面，建议预留50GB以上空间，因为BE的数据存储目录会随着数据量增长而膨胀。

软件环境方面，CentOS 7.x或Ubuntu 18.04+都是不错的选择。必须提前安装好Java 8或11（FE依赖Java环境），以及MySQL客户端工具。这里有个小技巧：如果你不确定Java环境是否配置正确，可以先用java -version命令检查，避免后续出现莫名其妙的启动失败。

2.2 部署目录规划

良好的目录规划能让后续维护事半功倍。我推荐采用以下结构：

/opt/module/starrocks/ ├── fe # FE服务目录 ├── be # BE服务目录 └── apache_hdfs_broker # Broker服务目录 /opt/meta # FE元数据存储 /opt/storage # BE数据存储

这种分离式设计有几个好处：首先，各服务的数据和日志不会混在一起；其次，升级时可以单独替换某个组件而不影响其他服务；最后，当需要迁移到生产环境时，这种结构更容易扩展。记得提前创建这些目录并设置合适的权限，我遇到过因为权限问题导致BE无法写入数据的坑。

3. 安装与配置StarRocks

3.1 获取并解压安装包

StarRocks社区版可以直接从官网下载。这里有个建议：下载前先查看版本发布说明，选择经过充分测试的稳定版本。我曾经为了尝鲜用了刚发布的新版本，结果遇到了不少已知bug。

解压命令很简单：

tar xvf StarRocks-1.19.2.tar.gz -C /opt/module/ mv /opt/module/StarRocks-1.19.2 /opt/module/starrocks

解压后你会看到一个结构清晰的目录树，其中最重要的是fe、be和apache_hdfs_broker三个子目录。建议花几分钟浏览这些目录，熟悉各个文件的作用，这对后续排查问题很有帮助。

3.2 配置FE服务

FE的配置文件位于fe/conf/fe.conf，测试环境下我们主要关注三个参数：

meta_dir = /opt/meta priority_networks = 192.168.110.98/32 http_port = 8030

meta_dir指定元数据存储位置，这是FE最重要的配置，一旦丢失就需要从头重建集群。priority_networks在多网卡环境下特别重要，它能避免FE绑定到错误的IP地址。我曾经因为没配这个参数，导致BE无法连接到FE，排查了半天才发现问题。

启动FE的命令很简单：

cd /opt/module/starrocks/fe/bin ./start_fe.sh --daemon

启动后可以用jps命令查看是否有StarRocksFe进程，或者检查fe/log/fe.log中的启动日志。第一次启动可能会花费较长时间，因为FE需要初始化元数据存储。

4. 部署BE与Broker服务

4.1 配置并启动BE

BE的配置文件是be/conf/be.conf，关键的配置项包括：

storage_root_path = /opt/storage priority_networks = 192.168.110.98/32 be_port = 9060

storage_root_path可以指定多个磁盘路径，用分号分隔，但在单机测试时一个路径就够了。BE对磁盘IO要求较高，如果有SSD最好优先使用。

启动BE服务：

cd /opt/module/starrocks/be/bin ./start_be.sh --daemon

验证BE是否正常运行：

ps -ef | grep starrocks_be tail -f /opt/module/starrocks/be/log/be.INFO

BE启动后不会立即加入集群，需要先在FE中添加它。这个顺序很重要，我见过有人先启动BE再加FE，结果BE不断报连接失败的错误。

4.2 配置Broker服务

Broker的配置相对简单，通常使用默认配置即可。启动命令：

cd /opt/module/starrocks/apache_hdfs_broker/bin ./start_broker.sh --daemon

验证Broker是否运行：

jps | grep BrokerBootstrap

Broker是无状态服务，可以随时启停。如果你暂时不需要访问HDFS或对象存储，甚至可以跳过Broker的部署。

5. 集群管理与基础操作

5.1 将节点加入集群

使用MySQL客户端连接FE（默认端口9030，用户root，密码为空）：

mysql -h127.0.0.1 -P9030 -uroot

添加BE节点：

ALTER SYSTEM ADD BACKEND '192.168.110.98:9050';

添加Broker节点：

ALTER SYSTEM ADD BROKER hdfs_broker '192.168.110.98:8000';

查询节点状态：

SHOW FRONTENDS; SHOW BACKENDS; SHOW BROKER;

这些命令的输出能帮你确认各个服务是否正常加入集群。如果状态异常，最常见的解决方法是检查端口是否开放，以及防火墙设置。

5.2 基础数据库操作

修改root密码（强烈建议）：

SET PASSWORD = PASSWORD('your_password');

创建测试数据库和表：

CREATE DATABASE test_db; USE test_db; CREATE TABLE test_table ( id INT, name VARCHAR(50), dt DATETIME ) DUPLICATE KEY(id) DISTRIBUTED BY HASH(id) BUCKETS 8 PROPERTIES ("replication_num" = "1");

注意单机环境下必须设置replication_num=1，因为只有一个BE节点。我曾经忘记设置这个参数，结果表一直处于不可用状态。

6. 数据导入与查询验证

6.1 插入测试数据

使用INSERT语句直接插入数据：

INSERT INTO test_table VALUES (1, 'Alice', '2023-01-01 10:00:00'), (2, 'Bob', '2023-01-02 11:00:00');

小批量插入适合验证基本功能，但StarRocks真正的优势在于大批量数据导入。你可以尝试使用Stream Load或Broker Load导入更大的数据集，体验StarRocks的高性能导入能力。

6.2 执行查询测试

简单查询：

SELECT * FROM test_table WHERE name LIKE 'A%';

聚合查询：

SELECT DATE(dt) AS day, COUNT(*) AS cnt FROM test_table GROUP BY day;

这些查询应该能立即返回结果。如果遇到性能问题，可以检查BE的CPU和内存使用情况。单机部署时资源竞争是常见瓶颈。

7. 常见问题排查

7.1 服务启动失败

FE启动失败常见原因：

• Java环境问题：确保JAVA_HOME设置正确
• 端口冲突：检查8030、9030等端口是否被占用
• 元数据目录权限：确保FE用户有读写权限

BE启动失败常见原因：

• 内存不足：单机部署时可能需要调整BE的内存参数
• 存储目录问题：检查storage_root_path是否存在且可写
• 端口冲突：检查9060、8040等端口

7.2 节点无法加入集群

常见症状：

• BE一直显示Alive=false
• Broker状态不稳定

解决方法：

1. 检查FE的priority_networks配置
2. 验证网络连通性（telnet IP port）
3. 查看各服务的错误日志
4. 如果问题持续，可以尝试清空元数据和存储目录，从头开始部署

8. 进阶配置建议

8.1 内存参数调优

在单机环境下，需要合理分配FE和BE的内存：

# FE配置(fe.conf) JAVA_OPTS = "-Xmx8G -Xms8G" # BE配置(be.conf) mem_limit = 60%

这些值需要根据机器实际内存调整。我的经验法则是：给FE分配4-8GB，给BE保留至少50%的系统内存。

8.2 监控与日志

StarRocks内置了简单的监控页面：

• FE监控：http://FE_IP:8030
• BE监控：http://BE_IP:8040

日常运维时要养成查看日志的习惯：

# FE日志 tail -f fe/log/fe.log # BE日志 tail -f be/log/be.INFO

对于长期运行的测试环境，建议配置日志轮转，避免日志文件过大。