Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

Comment restaurer une réplique après une défaillance du stockage

View as MarkdownEdit this pageReport an issueSet up docs MCP

Copier la configuration d’accès depuis la réplique saine

Copiez le contenu du dossier access, qui contient les utilisateurs locaux, depuis la réplique saine :

/var/lib/clickhouse/access

Sauvegarder le dossier metadata depuis la réplique saine

  1. Accédez au répertoire de données de ClickHouse :
cd /var/lib/clickhouse
  1. Créez une sauvegarde du dossier metadata (y compris les liens symboliques) : le répertoire metadata contient les DDLs des bases de données et des tables. Le répertoire de base de données contient des liens symboliques vers /var/lib/clickhouse/store/.., qui contient tous les DDLs des tables.
{ find metadata -type f; find metadata -type l; find metadata -type l | xargs readlink -f; } | tar -cPf backup.tar --files-from=-

Restaurer les métadonnées sur la réplique défaillante

  1. Copiez le fichier backup.tar généré vers la réplique défaillante.
  2. Extrayez-le dans le répertoire de données de ClickHouse :
cd /var/lib/clickhouse/
tar -xvPf backup.tar

Créer l’indicateur de restauration forcée

Pour déclencher la synchronisation automatique des données depuis les autres répliques, créez l’indicateur suivant :

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

Redémarrer la réplique défaillante

  1. Redémarrez le serveur ClickHouse sur le nœud défaillant.
  2. Vérifiez les logs du serveur ; vous devriez voir des parts téléchargées depuis les répliques saines :
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