> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# system.keeper_cluster

> Системная таблица, которая существует только на узле с запущенным ClickHouse Keeper в том же процессе. Содержит по одной строке для каждого участника кластера Raft, как его видит данный Keeper.

> [!NOTE]
>
> **Запросы в ClickHouse Cloud**
>
> Данные в этой системной таблице хранятся локально на каждом узле ClickHouse Cloud. Поэтому, чтобы получить полное представление обо всех данных, требуется функция `clusterAllReplicas`. Дополнительные сведения см. [здесь](https://clickhouse.com/docs/ru/reference/system-tables/overview.md#system-tables-in-clickhouse-cloud).

## Описание

Эта таблица отсутствует, если данный узел не настроен на запуск ClickHouse Keeper в том же процессе. Она содержит по одной строке для каждого участника кластера Raft, объединяя статическую топологию кластера (из конфигурации Raft) с позицией собственного лога локального узла.

Каждый узел заполняет ровно одно значение `last_log_index` — в строке, соответствующей его собственному `server_id`. Позиции логов peer здесь не отображаются, поскольку они отслеживаются только на лидере, и это представление не симметрично для всего кластера.

## Столбцы

* `server_id` ([Int32](https://clickhouse.com/docs/ru/reference/data-types/int-uint.md)) — Идентификатор Raft-сервера этого участника кластера.
* `host` ([String](https://clickhouse.com/docs/ru/reference/data-types/string.md)) — Хост, извлечённый из конечной точки (префикс перед последним двоеточием).
* `endpoint` ([String](https://clickhouse.com/docs/ru/reference/data-types/string.md)) — Исходная конечная точка Raft в настроенном виде (host:port).
* `is_observer` ([Bool](https://clickhouse.com/docs/ru/reference/data-types/boolean.md)) — True, если этот участник является наблюдателем без права голоса.
* `priority` ([Int32](https://clickhouse.com/docs/ru/reference/data-types/int-uint.md)) — Приоритет Raft этого участника; при выборе лидера предпочтение отдаётся более высоким значениям.
* `is_leader` ([Bool](https://clickhouse.com/docs/ru/reference/data-types/boolean.md)) — True, если этот участник является текущим лидером Raft.
* `is_self` ([Bool](https://clickhouse.com/docs/ru/reference/data-types/boolean.md)) — True, если эта строка описывает локальный узел Keeper.
* `last_log_index` ([Nullable(UInt64)](https://clickhouse.com/docs/ru/reference/data-types/nullable.md)) — Наибольший индекс Log в локальном хранилище Log Raft на этом узле. Заполняется только для строки, соответствующей текущему узлу (is\_self = true), NULL для остальных строк.

## Примеры

```sql theme={null}
SELECT * FROM system.keeper_cluster ORDER BY server_id;
```

```text theme={null}
┌─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   │           ᴺᵁᴸᴸ │
└───────────┴───────┴────────────┴─────────────┴──────────┴───────────┴─────────┴────────────────┘
```
