diff --git a/docs/home/clickhouse/rebalancing.md b/docs/home/clickhouse/shard-addition.md similarity index 95% rename from docs/home/clickhouse/rebalancing.md rename to docs/home/clickhouse/shard-addition.md index e9674083..bc1453bf 100644 --- a/docs/home/clickhouse/rebalancing.md +++ b/docs/home/clickhouse/shard-addition.md @@ -1,7 +1,10 @@ -# ClickHouse Rebalancing +# ClickHouse Shard Addition Rebalancing shards in ClickHouse is primarily a manual process due to inherent [limitations](https://clickhouse.com/docs/en/guides/sre/scaling-clusters) in ClickHouse. To simplify this process, we have developed a tool to assist with shard rebalancing. +!!! warning + Avoid adding shards during an ODM upgrade, as schema migrations may leave the cluster in an inconsistent state. + ## Prerequisites - Ensure there are no running ODM tasks. Wait for all tasks to complete before proceeding. This step is crucial to maintain data consistency in ClickHouse. diff --git a/mkdocs.yml b/mkdocs.yml index 0450d44f..f1015ec8 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -22,7 +22,7 @@ nav: - Helm: - How to deploy: home/helm/how-to-deploy.md - Clickhouse: - - Rebalancing: home/clickhouse/rebalancing.md + - Shard Addition: home/clickhouse/shard-addition.md - Troubleshooting: - AWS S3: home/troubleshooting/aws-s3.md - Azure SSO: home/troubleshooting/azure-sso.md