Como restaurar uma réplica após uma falha de armazenamento

Este guia pressupõe que o parâmetro <path> no arquivo config.xml esteja definido como:

<path>/var/lib/clickhouse/</path>

Se você tiver configurado um caminho de dados diferente, substitua todas as ocorrências de /var/lib/clickhouse nos comandos abaixo pelo valor real da sua configuração <path>.

Copie a configuração de acesso da réplica íntegra

Copie o conteúdo da pasta access, que contém os usuários locais, da réplica íntegra:

/var/lib/clickhouse/access

Faça backup da pasta de metadados da réplica íntegra

Navegue até o diretório de dados do ClickHouse:

cd /var/lib/clickhouse

Crie um backup da pasta de metadados (incluindo links simbólicos): o diretório de metadados contém os DDLs dos bancos de dados e das tabelas. O diretório do banco de dados tem links simbólicos para /var/lib/clickhouse/store/.., que contém todos os DDLs das tabelas.

{ find metadata -type f; find metadata -type l; find metadata -type l | xargs readlink -f; } | tar -cPf backup.tar --files-from=-

Este comando garante que tanto os arquivos de metadados quanto a estrutura dos links simbólicos sejam preservados no backup.

Restaure os metadados na réplica com falha

Copie o arquivo backup.tar gerado para a réplica com falha.
Extraia-o no diretório de dados do ClickHouse:

cd /var/lib/clickhouse/
tar -xvPf backup.tar

Crie a flag de restauração forçada

Para acionar a sincronização automática de dados a partir de outras réplicas, crie a seguinte flag:

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

Reinicie a réplica com falha

Reinicie o servidor ClickHouse no nó com falha.
Verifique os logs do servidor. Você deverá observar partes sendo baixadas das réplicas íntegras:

11.02 00:00:04.047097 [ 682 ] {} <Debug> analytics.events_local (...) (Fetcher): Downloading files 23
11.02 00:00:04.055542 [ 682 ] {} <Debug> analytics.events_local (...) (Fetcher): Download of part 202511_0_0_0 onto disk disk2 finished.
11.02 00:00:04.101888 [ 687 ] {} <Debug> warehouse.customers_local (...) (Fetcher): Downloading part 2025_0_0_1 onto disk default.
11.02 00:00:04.102005 [ 687 ] {} <Debug> warehouse.customers_local (...) (Fetcher): Downloading files 11
11.02 00:00:04.102210 [ 690 ] {} <Debug> warehouse.customers_local (...) (Fetcher): Downloading part 2022_0_0_1 onto disk disk1.
11.02 00:00:04.102247 [ 688 ] {} <Debug> warehouse.customers_local (...) (Fetcher): Downloading part 2021_0_0_1 onto disk disk2.
11.02 00:00:04.102331 [ 690 ] {} <Debug> warehouse.customers_local (...) (Fetcher): Downloading files 11