StarRocks Docker 镜像使用指南

什么是 StarRocks？

StarRocks 是一款新一代高性能分析型数据仓库，支持实时、多维、高并发的数据解析。它采用 MPP 架构，配备全向量化执行引擎、支持实时更新的列式存储引擎，并拥有丰富功能，如全自定义基于成本的优化器（CBO）、智能物化视图等。StarRocks 支持从多种数据源实时或批量摄入数据，还能零数据迁移直接分析数据湖中的数据。

更多信息参见 ***文档

架构组成

StarRocks 由前端（FE）、后端（BE）节点组成，若使用对象存储计算场景，还需包含 CN 节点。

FE（前端节点）

FE 负责元数据管理、客户端连接管理、查询规划及查询调度。每个 FE 在内存中存储并维护完整的元数据副本，确保各 FE 服务无差异。FE 可作为 leader、follower 或 observer 节点，其中 follower 节点通过类 Paxos 的 BDB JE 协议（BDB JE 即 Berkeley DB Java Edition）选举 leader。

BE（后端节点）

BE 负责数据存储与 SQL 执行。

数据存储

BE 具备数据存储能力。FE 根据预设规则将数据分发至 BE，BE 对摄入的数据进行转换，按指定格式写入并生成索引。

SQL 执行

当 SQL 查询请求到达时，FE 根据查询语义将其解析为逻辑执行计划，再转换为可在 BE 上执行的物理执行计划。存储目标数据的 BE 直接执行查询，无需数据传输与复制，实现高效查询。

CN（计算节点）

CN 是无状态的 BE 节点，数据存储于对象存储而非本地存储。CN 节点负责数据加载、查询计算、缓存管理等任务。

架构详情

如何使用此镜像

以下每个使用场景均提供快速入门指南（分步教程）。

Allin1 单容器部署

通过 StarRocks 基础教程 部署包含 StarRocks 前端与后端的单容器，加载并分析数据。

存储与计算分离部署

参考共享数据 快速入门教程 部署 StarRocks 与 MinIO。可修改提供的 Docker Compose 文件，切换至 S3、GCS、Azure 或其他对象存储。

Compose 文件示例

Helm/Operator 部署

通过 StarRocks Helm 图表与 Kubernetes operator 部署：

快速入门教程

Operator 仓库（含更多示例）

使用 MySQL 客户端连接 StarRocks

通过 MySQL 协议连接 StarRocks 的默认端口为 9030。提供的 Docker Compose 文件会暴露 9030 端口，配置示例如下：

yaml
    ports:
      - "8030:8030"
      - "9020:9020"
      - "9030:9030"

若通过命令行运行容器，可按如下方式暴露端口：

bash
docker run -p 9030:9030 ...

暴露 9030 端口后，执行以下命令连接：

bash
mysql -P9030 -h 127.0.0.1 -u root --prompt="StarRocks > " -p

若未为 root 配置密码，提示输入时直接回车即可。

也可使用容器内置的 MySQL 客户端：

bash
docker compose exec starrocks-fe \
mysql -P9030 -h127.0.0.1 -uroot --prompt="StarRocks > "

或：

bash
docker exec -ti starrocks-fe mysql -P9030 -h127.0.0.1 -uroot --prompt="StarRocks > " -p

提示：上述 exec 命令中，需将 starrocks-fe 替换为实际的服务名或容器名。

DBeaver 等其他客户端

可使用任何支持 MySQL 协议的客户端，只需将默认 MySQL 端口替换为 9030 即可。