> ## 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.clusters

<div id="description">
  ## Описание
</div>

Содержит информацию о кластерах, доступных в файле конфигурации, и входящих в них серверах.

<div id="Columns">
  ## Столбцы
</div>

* `cluster` ([String](/docs/ru/reference/data-types/string)) — Имя кластера.
* `shard_num` ([UInt32](/docs/ru/reference/data-types/int-uint)) — Номер сегмента в кластере, начиная с 1.
* `shard_name` ([String](/docs/ru/reference/data-types/string)) — Имя сегмента в кластере.
* `shard_weight` ([UInt32](/docs/ru/reference/data-types/int-uint)) — Относительный вес сегмента при записи данных.
* `internal_replication` ([UInt8](/docs/ru/reference/data-types/int-uint)) — Флаг, указывающий, входит ли этот хост в группу, способную самостоятельно реплицировать данные.
* `replica_num` ([UInt32](/docs/ru/reference/data-types/int-uint)) — Номер реплики в сегменте, начиная с 1.
* `host_name` ([String](/docs/ru/reference/data-types/string)) — Имя хоста, указанное в конфигурации.
* `host_address` ([String](/docs/ru/reference/data-types/string)) — IP-адрес хоста, полученный из DNS.
* `port` ([UInt16](/docs/ru/reference/data-types/int-uint)) — Порт для подключения к серверу.
* `is_local` ([UInt8](/docs/ru/reference/data-types/int-uint)) — Флаг, указывающий, является ли хост локальным.
* `user` ([String](/docs/ru/reference/data-types/string)) — Имя пользователя для подключения к серверу.
* `default_database` ([String](/docs/ru/reference/data-types/string)) — Имя базы данных по умолчанию.
* `errors_count` ([UInt32](/docs/ru/reference/data-types/int-uint)) — Количество неудачных попыток этого хоста связаться с репликой.
* `slowdowns_count` ([UInt32](/docs/ru/reference/data-types/int-uint)) — Количество замедлений, приведших к смене реплики при установлении соединения с хеджированными запросами.
* `estimated_recovery_time` ([UInt32](/docs/ru/reference/data-types/int-uint)) — Количество секунд до обнуления счётчика ошибок реплики, после чего она будет считаться работающей в штатном режиме.
* `database_shard_name` ([String](/docs/ru/reference/data-types/string)) — Имя сегмента базы данных `Replicated` (для кластеров, принадлежащих базе данных `Replicated`).
* `database_replica_name` ([String](/docs/ru/reference/data-types/string)) — Имя реплики базы данных `Replicated` (для кластеров, принадлежащих базе данных `Replicated`).
* `is_shared_catalog_cluster` ([UInt8](/docs/ru/reference/data-types/int-uint)) — Bool, указывающий, принадлежит ли кластер общему каталогу.
* `is_active` ([Nullable(UInt8)](/docs/ru/reference/data-types/nullable)) — Статус реплики базы данных `Replicated` (для кластеров, принадлежащих базе данных `Replicated`): 1 означает 'реплика активна', 0 означает 'реплика неактивна', NULL означает 'неизвестно'.
* `unsynced_after_recovery` ([Nullable(UInt8)](/docs/ru/reference/data-types/nullable)) — Указывает, превышает ли отставание репликации реплики базы данных `Replicated` значение max\_replication\_lag\_to\_enqueue после создания или восстановления реплики.
* `replication_lag` ([Nullable(UInt32)](/docs/ru/reference/data-types/nullable)) — Отставание репликации реплики базы данных `Replicated` (для кластеров, принадлежащих базе данных `Replicated`).
* `recovery_time` ([Nullable(UInt64)](/docs/ru/reference/data-types/nullable)) — Время восстановления реплики базы данных `Replicated` (для кластеров, принадлежащих базе данных `Replicated`), в миллисекундах.

**Псевдонимы:**

* `name` — Псевдоним для `cluster`.

<div id="example">
  ## Пример
</div>

```sql title="Query" theme={null}
SELECT * FROM system.clusters LIMIT 2 FORMAT Vertical;
```

```text title="Response" theme={null}
Row 1:
──────
cluster:                 test_cluster_two_shards
shard_num:               1
shard_name:              shard_01
shard_weight:            1
replica_num:             1
host_name:               127.0.0.1
host_address:            127.0.0.1
port:                    9000
is_local:                1
user:                    default
default_database:
errors_count:            0
slowdowns_count:         0
estimated_recovery_time: 0
database_shard_name:
database_replica_name:
is_active:               NULL

Row 2:
──────
cluster:                 test_cluster_two_shards
shard_num:               2
shard_name:              shard_02
shard_weight:            1
replica_num:             1
host_name:               127.0.0.2
host_address:            127.0.0.2
port:                    9000
is_local:                0
user:                    default
default_database:
errors_count:            0
slowdowns_count:         0
estimated_recovery_time: 0
database_shard_name:
database_replica_name:
is_active:               NULL
```

<div id="see-also">
  ## См. также
</div>

* [движок таблиц Distributed](/docs/ru/reference/engines/table-engines/special/distributed)
* [настройка distributed\_replica\_error\_cap](/docs/ru/reference/settings/session-settings/distributed-replica#distributed_replica_error_cap)
* [настройка distributed\_replica\_error\_half\_life](/docs/ru/reference/settings/session-settings/distributed-replica#distributed_replica_error_half_life)