system.keeper_cluster

Table système présente uniquement lorsque ce nœud exécute un ClickHouse Keeper intégré au processus. Contient une ligne par membre du cluster Raft tel qu’observé par ce Keeper.

Interroger dans ClickHouse Cloud

Les données de cette table système sont stockées localement sur chaque nœud de ClickHouse Cloud. Pour obtenir une vue complète de l’ensemble des données, il faut donc utiliser la fonction clusterAllReplicas. Consultez cette page pour plus de détails.

Description

Cette table n’existe pas si ce nœud n’est pas configuré pour exécuter un ClickHouse Keeper intégré au processus. Elle contient une ligne par membre du cluster Raft et combine la topologie statique du cluster (issue de la configuration Raft) avec la position du journal du nœud local.

Chaque nœud renseigne exactement une valeur last_log_index — la ligne correspondant à son propre server_id. Les positions de journal des autres nœuds n’apparaissent pas ici, car elles ne sont suivies que par le leader et cette vue n’est pas symétrique à l’échelle du cluster.

Colonnes

• server_id (Int32) — ID du serveur Raft de ce membre du cluster.
• host (String) — Hôte extrait de l’endpoint (préfixe avant le dernier deux-points).
• endpoint (String) — Endpoint Raft brut tel qu’il est configuré (host:port).
• is_observer (Bool) — true si ce membre est un observateur sans droit de vote, configuré via <can_become_leader>false</can_become_leader>.
• priority (Int32) — Priorité Raft de ce membre ; les valeurs les plus élevées sont privilégiées lors de l’élection du leader.
• is_leader (Bool) — true si ce membre est le leader Raft actuel.
• is_self (Bool) — true si cette ligne décrit le nœud Keeper local.
• last_log_index (Nullable(UInt64)) — Index de log le plus élevé dans le stockage local du journal Raft sur ce nœud. Renseigné uniquement sur la ligne correspondant au nœud actuel (is_self = true) ; NULL pour les autres lignes.

Exemple :

SELECT * FROM system.keeper_cluster ORDER BY server_id;

┌─server_id─┬─host──┬─endpoint───┬─is_observer─┬─priority─┬─is_leader─┬─is_self─┬─last_log_index─┐
│         1 │ node1 │ node1:9234 │ false       │        3 │ true      │ true    │             42 │
│         2 │ node2 │ node2:9234 │ false       │        2 │ false     │ false   │           ᴺᵁᴸᴸ │
│         3 │ node3 │ node3:9234 │ true        │        1 │ false     │ false   │           ᴺᵁᴸᴸ │
└───────────┴───────┴────────────┴─────────────┴──────────┴───────────┴─────────┴────────────────┘