From 1bc49e46e7fa09176ac2f1b0712c47efb41d7f5d Mon Sep 17 00:00:00 2001 From: Oleg Kunitsyn Date: Tue, 24 Mar 2026 11:14:33 +0100 Subject: [PATCH] [ODM-13172] Update documentation --- docs/home/clickhouse/{rebalancing.md => shard-addition.md} | 5 ++++- mkdocs.yml | 2 +- 2 files changed, 5 insertions(+), 2 deletions(-) rename docs/home/clickhouse/{rebalancing.md => shard-addition.md} (95%) 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