ClickHouse Operator

OLAP 分析

开源

在 Kubernetes 上运行高性能 ClickHouse 分析数据库

KubeBlocks ClickHouse Operator 支持 Standalone 与 Keeper HA 集群两种部署模式，最高支持 128 个分片，提供 MergeTree 系列引擎管理与 ClickHouse Keeper 协调，为实时 OLAP 分析提供亿级数据秒级查询能力。

访问 GitHub

128

最大分片数

2 种

部署拓扑

100%

开源免费

2 步部署生产级 ClickHouse Operator

安装 KubeBlocks

# 添加 Helm 仓库
helm repo add kubeblocks https://apecloud.github.io/helm-charts
helm repo update

# 安装 KubeBlocks
helm install kubeblocks kubeblocks/kubeblocks \
  --namespace kb-system --create-namespace

创建 ClickHouse Operator 集群

apiVersion: apps.kubeblocks.io/v1
kind: Cluster
metadata:
  name: ch-cluster
  namespace: demo
spec:
  clusterDef: clickhouse
  terminationPolicy: Delete
  topology: standalone
  shardings:
    - name: clickhouse
      shards: 1
      template:
        name: clickhouse
        replicas: 1

核心能力

最高 128 分片扩展

横向分片突破单机存储瓶颈，Standalone 与 Keeper 集群模式均支持最多 128 个分片，读写线性扩展。

MergeTree 引擎家族

支持 MergeTree、ReplicatedMergeTree、SummingMergeTree 等引擎，按业务场景选择最优存储策略。

ClickHouse Keeper 内置协调

内置 ClickHouse Keeper（ZooKeeper 兼容，基于 Raft），自动管理副本间数据同步与分布式 DDL 执行。

列式压缩高效存储

列式存储 + LZ4/ZSTD 压缩，同等数据量下磁盘占用降低 5-10 倍，查询 I/O 大幅减少。

部署拓扑

Standalone 独立模式

一个或多个独立 ClickHouse 分片，无协调组件，支持 MergeTree 引擎全系列。适合中小规模 OLAP 分析，最多支持 128 个分片线性扩展查询吞吐。

无协调组件

MergeTree

最多 128 分片

开发/生产

关键特性

独立分片，无副本复制，无需 Keeper 协调

支持 MergeTree 引擎全系列（不含 ReplicatedMergeTree）

最多支持 128 个分片，横向扩展查询吞吐

HTTP（:8123）与原生 TCP（:9000）客户端双协议支持

支持全量与增量备份，Prometheus 指标暴露（:8001）

应用 / 客户端

HTTP {cluster}-{shardComponentName}:8123
原生协议 {cluster}-{shardComponentName}:9000

HTTP / 原生 TCP

Kubernetes 服务（每个分片一个）

{cluster}-clickhouse-XXX

ClusterIP · :8123 HTTP接口 · :9000 原生协议 · :8001 指标
选取分片内所有副本（无 roleSelector）

所有副本

→ 所有副本（负载均衡）

独立分片（单机拓扑）

分片 0

clickhouse-abc-0Pod

🖱️

clickhouse

:8123 · :9000 · :9004 MySQL · :9005 PG · :8001

💾 PVC data · 10Gi

分片 1（可选）

clickhouse-xyz-0Pod

🖱️

clickhouse

:8123 · :9000 · :9004 MySQL · :9005 PG · :8001

💾 PVC data · 10Gi

ℹ每个分片相互独立 — 分片间无复制。请使用 MergeTree（而非 ReplicatedMergeTree）。

🔗无头服务（每个分片一个）— 为 Operator 探针提供稳定的 Pod DNS；非客户端端点

客户端流量

独立分片节点 Pod

持久化存储

可选 / 额外分片

常见问题

KubeBlocks ClickHouse Operator 支持哪些 ClickHouse 版本？

KubeBlocks ClickHouse Operator 支持 ClickHouse 24.x 等主流版本。

Standalone 与 Keeper 集群模式如何选择？

Standalone 适合对数据副本要求不高、以查询吞吐为主的 OLAP 场景；Keeper 集群模式适合对数据高可用有要求的生产场景，支持 ReplicatedMergeTree 实现多副本数据安全。

KubeBlocks ClickHouse Operator 是否免费？

KubeBlocks开源版完全开源免费。KubeBlocks企业版提供图形化控制台与商业支持等增值功能。