ClickHouse replication et cluster : tutoriel 2026

Configurer la replication ClickHouse pour HA en 2026.

Voir notre guide ClickHouse.

Architecture

• 2 nœuds ClickHouse (replicas)
• 3 nœuds ClickHouse Keeper (consensus, remplace ZooKeeper)
• ReplicatedMergeTree tables avec consensus

Setup ClickHouse Keeper

# config.xml sur chaque nœud
<keeper_server>
  <tcp_port>9181</tcp_port>
  <server_id>1</server_id>
  <raft_configuration>
    <server>
      <id>1</id>
      <hostname>ck-keeper-01</hostname>
      <port>9234</port>
    </server>
    ...
  </raft_configuration>
</keeper_server>

Table répliquée

CREATE TABLE events ON CLUSTER 'main' (
  ...
)
ENGINE = ReplicatedMergeTree('/clickhouse/tables/{shard}/events', '{replica}')
ORDER BY (event_name, timestamp);

Sharding

Pour gros volumes : Distributed table par-dessus ReplicatedMergeTree, avec sharding key (ex: cityHash64(user_id)).

Pour aller plus loin

• Guide ClickHouse