From 7fd0158dc1f76f10c610d423b1120ec8dc38529b Mon Sep 17 00:00:00 2001 From: Kseniia Antonova Date: Wed, 18 Feb 2026 00:45:23 +0300 Subject: [PATCH] Add note about checking data schema before rebalancing Fixes #5535 --- doc/book/admin/vshard_admin.rst | 3 +++ locale/ru/LC_MESSAGES/book/admin/vshard_admin.po | 9 +++++++++ 2 files changed, 12 insertions(+) diff --git a/doc/book/admin/vshard_admin.rst b/doc/book/admin/vshard_admin.rst index 59a66795b..65c49ea51 100644 --- a/doc/book/admin/vshard_admin.rst +++ b/doc/book/admin/vshard_admin.rst @@ -186,6 +186,9 @@ loaded replica sets to the zero-load replica set. .. note:: A new zero-load replica set should be assigned a weight for rebalancing to start. + Before migrating buckets to a new replica set, it's important to check the data schema on the added storage. + The data schema on the new storage must match the schema of the other storages in the cluster. + Mismatches in data schemas may lead to rebalancing errors, including the halt of the migration process. When a new shard is added, the configuration can be updated dynamically: diff --git a/locale/ru/LC_MESSAGES/book/admin/vshard_admin.po b/locale/ru/LC_MESSAGES/book/admin/vshard_admin.po index 3ab375e2c..b80653eed 100644 --- a/locale/ru/LC_MESSAGES/book/admin/vshard_admin.po +++ b/locale/ru/LC_MESSAGES/book/admin/vshard_admin.po @@ -358,9 +358,18 @@ msgstr "" msgid "" "A new zero-load replica set should be assigned a weight for rebalancing to " "start." +" Before migrating buckets to a new replica set, it's important to check the " +"data schema on the added storage. The data schema on the new storage must " +"match the schema of the other storages in the cluster. Mismatches " +"in data schemas may lead to rebalancing errors, including the halt of the migration process." + msgstr "" "Новому набору реплик с нулевой нагрузкой следует присвоить вес, чтобы начать" " процесс балансировки." +" Перед началом миграции сегментов на новый набор реплик важно проверить " +"схему данных на добавленном хранилище. Схема данных на новом хранилище должна " +"совпадать со схемой на других хранилищах в кластере. Несовпадения " +"схемы данных может привести к ошибкам при ребалансировке, вплоть до остановки процесса миграции сегментов." msgid "" "When a new shard is added, the configuration can be updated dynamically:"