После переноса таблицы данные могут читаться из прежнего кластера через оставшийся Distributed-маршрут, словарь или представление. Поэтому до переключения составьте карту объектов: какие строки находятся локально, кто направляет чтение и какие внешние источники нужны запросу. Первый безопасный тест выполняется в новом изолированном назначении, не в рабочей таблице с тем же именем.
Копия принята не в тот момент, когда завершилось восстановление, а когда согласованный запрос использует ожидаемые данные и зависимости. Если требуется автономность нового кластера, доступ к старому окружению не должен незаметно обеспечивать успешность теста. При этом отключать рабочие сетевые маршруты ради проверки нельзя: изоляция проводится только на подготовленном стенде.
Перед переносом нарисуйте маршрут одного отчёта
Условная карта объектов:
report_view -> distributed_name
distributed_name -> <новый cluster / database / table>
local_table -> <новое хранилище>
dictionary -> <согласованный источник>
materialized_view -> <своя целевая таблица>
reader_role -> <только предусмотренный доступ>Для каждого объекта сохраните определение, назначение и владельца настройки. Имя кластера в определении и конфигурация этого имени на новом сервере — разные части маршрута. Совпавшее название не доказывает совпадение адресов или состава шардов. Сверку проводите от узла, который реально принимает запрос приложения, а не только от административного клиента.
| Объект | Что проверить в назначении | Почему одного наличия мало |
|---|---|---|
| Локальная таблица | Движок, структура, политика хранения | Настройки могли зависеть от старого окружения |
| Distributed | Кластер и целевые имена | Чтение может уходить на прежние узлы |
| Словарь | Источник, доступ и обновление | Текущие значения могут скрыть неверный refresh |
| Представление | Ссылки и целевую таблицу | Зависимость может остаться в другой базе |
Восстанавливайте в свободное назначение
Официальная документация ClickHouse показывает восстановление таблицы под новым именем. Она отдельно предупреждает: разрешение восстановления в непустую таблицу смешивает существующие данные с данными копии и может дать дубли. Проверено 15 октября 2026 года. Для репетиции используйте отдельное назначение и поддерживаемый для своих версий механизм; не снимайте защиту непустой таблицы просто ради повторного запуска.
До загрузки сопоставьте доступные диски, storage policy и внешние зависимости. Инструмент и его возможности зависят от версии и развёртывания; перенос между управляемым сервисом и собственным кластером требует отдельной проверки ограничений. Секреты подключения не переносят через текст статьи или открытый manifest. Нужные права выдаются по заранее согласованной модели нового окружения.
Материализованное представление требует проверки и исторических строк, и новых вставок. Не считайте, что повторная отправка всех исходных данных автоматически безопасна для его целевой таблицы. В репетиции отдельно проследите одно новое искусственное событие и его результат. Для текущего потока заранее задайте границу, до которой переносится история и после которой работает новый маршрут записи.
Приёмка проверяет независимость, а не только цифры
- Чтение начинается с того же типа клиента, что у приложения.
- Все ожидаемые шарды участвуют в результате.
- Внешние источники соответствуют карте нового окружения.
- Новое событие попадает в нужную локальную и производную таблицу.
- Повтор репетиции не смешивает старый тестовый набор с новым.
После начала записи в новом кластере старый перестаёт быть автоматически актуальной точкой возврата. План отката должен учитывать этот промежуток, а не ограничиваться сменой DNS или строки подключения. Для обсуждения переноса подготовьте определения объектов без секретов, карту зависимостей, версии и сценарий тестового отчёта. Результат считается понятным, когда для каждой строки и каждого внешнего обращения можно назвать ожидаемое назначение.