cluster-operations

Installation
SKILL.md

Cluster Operations

When to use this skill

Load when users ask about cluster management, distributed tables, or scaling.

Distributed Tables

  • CREATE TABLE dist ENGINE = Distributed(cluster, db, local_table, sharding_key)
  • Sharding key: rand() for even distribution, cityHash64(user_id) for user affinity
  • Reads: query all shards in parallel
  • Writes: can route to correct shard or write locally

Adding Nodes

  1. Install ClickHouse on new node
  2. Configure Keeper/ZooKeeper connection
  3. Update cluster config (remote_servers) on all nodes
  4. Create local tables on new node
  5. For ReplicatedMergeTree: data syncs automatically
  6. For non-replicated: manually copy data or re-insert
Related skills
Installs
2
GitHub Stars
217
First Seen
Apr 19, 2026