ApsaraDB for ClickHouse:ZooKeeper management

Prérequis

• Le statut du cluster est Running.

• Vous n'avez pas redémarré le cluster.

• Pour les instances achetées après le 13 mars 2025 avec une version 23.8 ou ultérieure, les instances utilisent ClickHouse Keeper, qui emploie un ZXID 64 bits. Dans ce cas, le débordement du ZXID ne pose pas de problème et le basculement du leader n'est pas requis.

  Important

  Une instance nouvellement achetée désigne une instance acquise via la console. Cela n'inclut pas les instances créées par restauration de sauvegarde, clonage ou mise à niveau d'instances existantes.

Impact sur le cluster

• Requêtes : aucun impact.

• Opérations d'écriture :

  • Les opérations d'écriture sur les tables utilisant un moteur ReplicatedMergeTree peuvent être brièvement interrompues.

  • Si la suspension des écritures est activée, l'instance bloque toutes les opérations d'écriture dès le début du basculement. Toutes les écritures sur l'instance échouent durant cette période.

• Opérations DDL : le basculement peut bloquer l'exécution distribuée des DDL.

• Durée :

  • Sans suspension des écritures : environ 1 à 2 minutes.

  • Avec suspension des écritures : environ 2 à 10 minutes (les opérations d'écriture sont bloquées pendant toute la durée).

• Risque d'incohérence des métadonnées.

  Un basculement du leader ZooKeeper déconnecte tous les nœuds ClickHouse de ZooKeeper. Des écritures à haute fréquence durant ce processus peuvent provoquer une incohérence des métadonnées et forcer certaines tables à passer en état Read-only.

  Pour éviter toute incohérence des métadonnées, réduisez la fréquence des écritures ou arrêtez les opérations d'écriture pendant la période de basculement.

Basculement du leader

1. Connectez-vous à la console ApsaraDB for ClickHouse.

2. Dans le coin supérieur gauche de la page, sélectionnez la région de votre cluster cible.

3. Sur la page Clusters, sélectionnez Clusters of Community-compatible Edition, puis cliquez sur l'ID du cluster cible.

4. Sur la page Cluster Information, dans la section Zookeeper Configurations sous Configuration Information, cliquez sur Scheduled Time.

5. Dans la boîte de dialogue Configure Primary/Secondary Switchover, consultez les impacts de cette opération, puis cliquez sur OK.

6. Dans la boîte de dialogue Configure Primary/Secondary Switchover, configurez les options Configure Write Suspension et Select Mode.

   • Configure Write Suspension :

     • Enable Write Suspension : l'instance bloque toutes les opérations d'écriture pendant le basculement. Le processus dure entre 2 et 10 minutes.

     • Disable Write Suspension : l'instance effectue le basculement du leader sans bloquer les opérations d'écriture.

   • Select Mode :

     • Scheduled Time : dans le champ Scheduled Time, définissez une heure pour le basculement du leader. Le basculement démarre à l'heure programmée.

     • Execute Immediately : le cluster démarre immédiatement le basculement du leader.

7. Cliquez sur OK.

   Remarque

   Une fois le basculement du leader démarré, le statut du cluster passe à Switching Primary/Secondary Node. L'opération est terminée lorsque le statut revient à Running.

Modifier ou annuler la planification

1. Connectez-vous à la console ApsaraDB for ClickHouse.

2. Dans le coin supérieur gauche de la page, sélectionnez la région de votre cluster cible.

3. Sur la page Clusters, sélectionnez Clusters of Community-compatible Edition, puis cliquez sur l'ID du cluster cible.

4. Sur la page Cluster Information, dans la section Zookeeper Configurations sous Configuration Information, cliquez sur Scheduled Time.

5. Dans la boîte de dialogue Configure Primary/Secondary Switchover, sélectionnez Modify ou Cancel.

   • Modify : vous pouvez modifier tous les paramètres de basculement du leader.

   • Cancel : annule le basculement du leader planifié.