system.keeper_cluster

仅当此节点运行进程内 ClickHouse Keeper 时，此系统表才存在。它包含此 Keeper 看到的每个 Raft 集群成员对应的一行。

在 ClickHouse Cloud 中查询

此系统表中的数据分别保存在 ClickHouse Cloud 各节点的本地。因此，如需查看所有数据的完整情况，需要使用 clusterAllReplicas 函数。更多详情请参见此处。

说明

如果此节点未配置为运行进程内 ClickHouse Keeper，则此表不存在。该表为 Raft 集群中的每个成员各包含一行，将静态集群拓扑 (来自 Raft 配置) 与本地节点自身的日志位置结合在一起。

每个节点只会填写一个 last_log_index 值——也就是与其自身 server_id 对应的那一行。其他节点的日志位置不会在此处显示，因为这些位置仅在 leader 上跟踪，而这个视图在整个集群中并不是对称的。

列

• server_id (Int32) — 此集群成员的 Raft server ID。
• host (String) — 从端点中解析出的主机 (最后一个冒号之前的前缀) 。
• endpoint (String) — 配置中的原始 Raft 端点 (host:port) 。
• is_observer (Bool) — 如果此成员是通过 <can_become_leader>false</can_become_leader> 配置的无投票权 observer，则为 true。
• priority (Int32) — 此成员的 Raft 优先级；在 leader election 期间，值越高越优先。
• is_leader (Bool) — 如果此成员是当前的 Raft leader，则为 true。
• is_self (Bool) — 如果此行描述的是本地 Keeper 节点，则为 true。
• last_log_index (Nullable(UInt64)) — 此节点本地 Raft 日志存储中的最高日志索引。仅在与当前节点对应的行 (is_self = true) 中填充；其他行为 NULL。

示例：

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   │           ᴺᵁᴸᴸ │
└───────────┴───────┴────────────┴─────────────┴──────────┴───────────┴─────────┴────────────────┘