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

Ce guide suppose que le paramètre <path> de votre fichier config.xml est défini comme suit :

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

Si vous avez configuré un autre chemin de données, remplacez toutes les occurrences de /var/lib/clickhouse dans les commandes ci-dessous par la valeur réelle de votre paramètre <path>.

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

Accédez au répertoire de données de ClickHouse :

cd /var/lib/clickhouse

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=-

Cette commande garantit que les fichiers de métadonnées et la structure des liens symboliques sont préservés dans la sauvegarde.

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

Copiez le fichier backup.tar généré vers la réplique défaillante.
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

Redémarrez le serveur ClickHouse sur le nœud défaillant.
Vérifiez les logs du serveur ; vous devriez voir des parts téléchargées depuis les répliques saines :

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