Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

Как восстановить реплику после сбоя хранилища

View as MarkdownEdit this pageReport an issueSet up docs MCP

Скопируйте настройки доступа с исправной реплики

Скопируйте содержимое каталога access, в котором хранятся локальные пользователи, с исправной реплики:

/var/lib/clickhouse/access

Сделайте резервную копию каталога metadata с исправной реплики

  1. Перейдите в каталог данных ClickHouse:
cd /var/lib/clickhouse
  1. Создайте резервную копию каталога metadata (включая символические ссылки): каталог metadata содержит DDL-запросы для баз данных и таблиц. Каталог базы данных содержит символические ссылки на /var/lib/clickhouse/store/.., где находятся все DDL-запросы таблиц.
{ find metadata -type f; find metadata -type l; find metadata -type l | xargs readlink -f; } | tar -cPf backup.tar --files-from=-

Восстановите metadata на неисправной реплике

  1. Скопируйте созданный файл backup.tar на неисправную реплику.
  2. Распакуйте его в каталог данных ClickHouse:
cd /var/lib/clickhouse/
tar -xvPf backup.tar

Создайте флаг принудительного восстановления

Чтобы запустить автоматическую синхронизацию данных с других реплик, создайте следующий флаг:

sudo -u clickhouse touch /var/lib/clickhouse/flags/force_restore_data

Перезапустите неисправную реплику

  1. Перезапустите сервер ClickHouse на неисправном узле.
  2. Проверьте серверный журнал: вы должны увидеть, что части загружаются с исправных реплик:
2025.11.02 00:00:04.047097 [ 682 ] {} <Debug> analytics.events_local (...) (Fetcher): Downloading files 23
2025.11.02 00:00:04.055542 [ 682 ] {} <Debug> analytics.events_local (...) (Fetcher): Download of part 202511_0_0_0 onto disk disk2 finished.
2025.11.02 00:00:04.101888 [ 687 ] {} <Debug> warehouse.customers_local (...) (Fetcher): Downloading part 2025_0_0_1 onto disk default.
2025.11.02 00:00:04.102005 [ 687 ] {} <Debug> warehouse.customers_local (...) (Fetcher): Downloading files 11
2025.11.02 00:00:04.102210 [ 690 ] {} <Debug> warehouse.customers_local (...) (Fetcher): Downloading part 2022_0_0_1 onto disk disk1.
2025.11.02 00:00:04.102247 [ 688 ] {} <Debug> warehouse.customers_local (...) (Fetcher): Downloading part 2021_0_0_1 onto disk disk2.
2025.11.02 00:00:04.102331 [ 690 ] {} <Debug> warehouse.customers_local (...) (Fetcher): Downloading files 11
Navigation