搭建 ClickHouse 分析集群

适用场景

需要高吞吐的列式分析、日志/指标存储和实时报表。ClickHouse 适合大范围扫描和聚合，不擅长高频点更新和复杂事务。

前置条件

至少 3 台节点或 Kubernetes 集群。
独立磁盘，建议 NVMe。
ClickHouse Keeper 或 ZooKeeper 用于副本协调。
明确分片、副本和保留策略。

步骤

使用 ClickHouse Operator 安装：

kubectl apply -f https://raw.githubusercontent.com/Altinity/clickhouse-operator/master/deploy/operator.yaml
kubectl -n kube-system get pods | grep clickhouse-operator

创建集群 CR：

kubectl apply -f - <<'EOF'
apiVersion: clickhouse.altinity.com/v1
kind: ClickHouseInstallation
metadata:
  name: prod
  namespace: clickhouse
spec:
  configuration:
    clusters:
    - name: main
      layout:
        shardsCount: 2
        replicasCount: 2
      templates:
        podTemplate: clickhouse-pod
  templates:
    podTemplates:
    - name: clickhouse-pod
      spec:
        containers:
        - name: clickhouse
          image: clickhouse/clickhouse-server:24.8
          resources:
            requests: {cpu: "4", memory: 16Gi}
EOF
kubectl -n clickhouse get pods

建表：

clickhouse-client --host clickhouse-main-0 --query "
CREATE TABLE events (
  dt Date,
  user_id UInt64,
  event String,
  amount Decimal(10,2)
) ENGINE = ReplicatedMergeTree('/clickhouse/tables/{shard}/events', '{replica}')
PARTITION BY toYYYYMM(dt)
ORDER BY (dt, user_id);"

导入数据：

clickhouse-client --query "INSERT INTO events FORMAT JSONEachRow" < events.jsonl

查询：

clickhouse-client --query "
SELECT dt, event, count() AS c, sum(amount) AS amt
FROM events
WHERE dt >= '2026-10-01'
GROUP BY dt, event
ORDER BY c DESC
LIMIT 10;"

验证

所有分片和副本正常。
写入后副本同步。
查询能利用分区裁剪。
Keeper 连接稳定。
备份和恢复演练成功。

回滚

升级前备份数据和配置。
使用 clickhouse-backup 或磁盘快照。
回滚版本时注意数据格式兼容性。
保留旧分片配置，避免副本无法加入。

常见坑

分片键选择不当，数据倾斜。
分区过多导致 merge 压力大。
副本表没有使用 ReplicatedMergeTree，数据不同步。
Keeper 单点或磁盘满，集群只读。
大批量小插入产生过多 parts。
查询没有时间范围，扫描全表。
内存限制过低，聚合查询 OOM。
没有监控 merge、replication lag 和磁盘。

搭建 ClickHouse 分析集群

适用场景

前置条件

步骤

验证

回滚

常见坑

相关命令