> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8a08bda2.mintlify.site/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](/ru/reference/data-types)) — Имя кластера.
* `shard_num` ([UInt32](/ru/reference/data-types)) — Номер сегмента в кластере, начиная с 1.
* `shard_name` ([String](/ru/reference/data-types)) — Имя сегмента в кластере.
* `shard_weight` ([UInt32](/ru/reference/data-types)) — Относительный вес сегмента при записи данных.
* `internal_replication` ([UInt8](/ru/reference/data-types)) — Флаг, указывающий, является ли этот узел частью группы, которая может реплицировать данные самостоятельно.
* `replica_num` ([UInt32](/ru/reference/data-types)) — Номер реплики в сегменте, начиная с 1.
* `host_name` ([String](/ru/reference/data-types)) — Имя хоста, как указано в конфигурации.
* `host_address` ([String](/ru/reference/data-types)) — IP-адрес хоста, полученный из DNS.
* `port` ([UInt16](/ru/reference/data-types)) — Порт, используемый для подключения к серверу.
* `is_local` ([UInt8](/ru/reference/data-types)) — Флаг, указывающий, является ли хост локальным.
* `user` ([String](/ru/reference/data-types)) — Имя пользователя для подключения к серверу.
* `default_database` ([String](/ru/reference/data-types)) — Имя базы данных по умолчанию.
* `errors_count` ([UInt32](/ru/reference/data-types)) — Количество случаев, когда этому хосту не удалось подключиться к реплике.
* `slowdowns_count` ([UInt32](/ru/reference/data-types)) — Количество замедлений, которые привели к смене реплики при установлении соединения с хеджированными запросами.
* `estimated_recovery_time` ([UInt32](/ru/reference/data-types)) — Число секунд, оставшихся до обнуления счетчика ошибок реплики, после чего она будет считаться вернувшейся в нормальное состояние.
* `database_shard_name` ([String](/ru/reference/data-types)) — Имя сегмента базы данных `Replicated` (для кластеров, принадлежащих базе данных `Replicated`).
* `database_replica_name` ([String](/ru/reference/data-types)) — Имя реплики базы данных `Replicated` (для кластеров, принадлежащих базе данных `Replicated`).
* `is_shared_catalog_cluster` ([UInt8](/ru/reference/data-types)) — Bool, указывающий, принадлежит ли кластер общему каталогу.
* `is_active` ([Nullable(UInt8)](/ru/reference/data-types)) — Статус реплики базы данных `Replicated` (для кластеров, принадлежащих базе данных `Replicated`): 1 означает 'реплика доступна', 0 означает 'реплика недоступна', NULL означает 'неизвестно'.
* `unsynced_after_recovery` ([Nullable(UInt8)](/ru/reference/data-types)) — Указывает, превышает ли задержка репликации реплики базы данных `Replicated` значение max\_replication\_lag\_to\_enqueue после создания или восстановления реплики.
* `replication_lag` ([Nullable(UInt32)](/ru/reference/data-types)) — Задержка репликации реплики базы данных `Replicated` (для кластеров, принадлежащих базе данных `Replicated`).
* `recovery_time` ([Nullable(UInt64)](/ru/reference/data-types)) — Время восстановления реплики базы данных `Replicated` (для кластеров, принадлежащих базе данных `Replicated`), в миллисекундах.

<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](/ru/reference/engines/table-engines/special/distributed)
* [настройка distributed\_replica\_error\_cap](/ru/reference/settings/session-settings#distributed_replica_error_cap)
* [настройка distributed\_replica\_error\_half\_life](/ru/reference/settings/session-settings#distributed_replica_error_half_life)