Skip to main content
Consultas no ClickHouse CloudOs dados nesta tabela de sistema são mantidos localmente em cada nó do ClickHouse Cloud. Portanto, para obter uma visão completa de todos os dados, é necessário usar a função clusterAllReplicas. Consulte aqui para mais detalhes.

Descrição

Esta tabela não existe se este nó não estiver configurado para executar um ClickHouse Keeper no próprio processo. Ela contém uma linha por membro do cluster Raft, combinando a topologia estática do cluster (da configuração do Raft) com a posição de log do próprio nó local. Cada nó preenche exatamente um valor de last_log_index — a linha correspondente ao seu próprio server_id. As posições de log dos outros nós não são exibidas aqui porque são rastreadas apenas no líder, e essa visão não é simétrica em todo o cluster.

Colunas

  • server_id (Int32) — ID do servidor Raft deste membro do cluster.
  • host (String) — Host extraído do endpoint (prefixo antes dos últimos dois-pontos).
  • endpoint (String) — Endpoint Raft bruto, conforme configurado (host:port).
  • is_observer (Bool) — true se este membro for um observador sem direito a voto, configurado por meio de <can_become_leader>false</can_become_leader>.
  • priority (Int32) — Prioridade Raft deste membro; valores mais altos têm preferência durante a eleição de líder.
  • is_leader (Bool) — true se este membro for o líder Raft atual.
  • is_self (Bool) — true se esta linha descrever o nó Keeper local.
  • last_log_index (Nullable(UInt64)) — Maior índice de log no armazenamento de log Raft local deste nó. Preenchido apenas na linha correspondente ao nó atual (is_self = true); NULL para as outras linhas.
Exemplo:
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   │           ᴺᵁᴸᴸ │
└───────────┴───────┴────────────┴─────────────┴──────────┴───────────┴─────────┴────────────────┘
Last modified on June 29, 2026