Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

Cómo restaurar una réplica tras un fallo de almacenamiento

View as MarkdownEdit this pageReport an issueSet up docs MCP

Copiar la configuración de acceso desde la réplica en buen estado

Copia el contenido de la carpeta access, que contiene los usuarios locales, desde la réplica en buen estado:

/var/lib/clickhouse/access

Hacer una copia de seguridad de la carpeta de metadatos desde la réplica en buen estado

  1. Ve al directorio de datos de ClickHouse:
cd /var/lib/clickhouse
  1. Crea una copia de seguridad de la carpeta de metadatos (incluidos los enlaces simbólicos): el directorio de metadatos contiene los DDLs de las bases de datos y las tablas. El directorio de la base de datos tiene enlaces simbólicos a /var/lib/clickhouse/store/.., que contiene todos los DDLs de las tablas.
{ find metadata -type f; find metadata -type l; find metadata -type l | xargs readlink -f; } | tar -cPf backup.tar --files-from=-

Restaurar los metadatos en la réplica afectada

  1. Copia el archivo backup.tar generado a la réplica afectada.
  2. Extráelo en el directorio de datos de ClickHouse:
cd /var/lib/clickhouse/
tar -xvPf backup.tar

Crear el indicador de restauración forzada

Para activar la sincronización automática de datos desde otras réplicas, crea el siguiente indicador:

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

Reiniciar la réplica afectada

  1. Reinicia el servidor ClickHouse en el nodo afectado.
  2. Comprueba los logs del servidor; deberías ver que se descargan partes desde las réplicas en buen estado:
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