Перейти к основному содержанию

​
Описание

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

​
Столбцы

  • cluster (String) — Имя кластера.
  • shard_num (UInt32) — Номер сегмента в кластере, начиная с 1.
  • shard_name (String) — Имя сегмента в кластере.
  • shard_weight (UInt32) — Относительный вес сегмента при записи данных.
  • internal_replication (UInt8) — Флаг, указывающий, является ли этот хост частью группы узлов, способной самостоятельно реплицировать данные.
  • replica_num (UInt32) — Номер реплики в сегменте, начиная с 1.
  • host_name (String) — Имя хоста, как указано в конфигурации.
  • host_address (String) — IP-адрес хоста, полученный через DNS.
  • port (UInt16) — Порт для подключения к серверу.
  • is_local (UInt8) — Флаг, указывающий, является ли хост локальным.
  • user (String) — Имя пользователя для подключения к серверу.
  • default_database (String) — Имя базы данных по умолчанию.
  • errors_count (UInt32) — Количество случаев, когда этому хосту не удалось обратиться к реплике.
  • slowdowns_count (UInt32) — Количество замедлений, которые привели к смене реплики при установлении соединения с хеджированными запросами.
  • estimated_recovery_time (UInt32) — Количество секунд, оставшихся до обнуления счётчика ошибок реплики, после чего она снова будет считаться работающей нормально.
  • database_shard_name (String) — Имя сегмента базы данных Replicated (для кластеров, принадлежащих базе данных Replicated).
  • database_replica_name (String) — Имя реплики базы данных Replicated (для кластеров, принадлежащих базе данных Replicated).
  • is_shared_catalog_cluster (UInt8) — Булево значение, указывающее, принадлежит ли кластер Shared Catalog.
  • is_active (Nullable(UInt8)) — Статус реплики базы данных Replicated (для кластеров, принадлежащих базе данных Replicated): 1 означает ‘реплика в сети’, 0 означает ‘реплика не в сети’, NULL означает ‘неизвестно’.
  • unsynced_after_recovery (Nullable(UInt8)) — Указывает, превышает ли отставание репликации у реплики базы данных Replicated значение max_replication_lag_to_enqueue после создания или восстановления реплики.
  • replication_lag (Nullable(UInt32)) — Отставание репликации реплики базы данных Replicated (для кластеров, принадлежащих базе данных Replicated).
  • recovery_time (Nullable(UInt64)) — Время восстановления реплики базы данных Replicated (для кластеров, принадлежащих базе данных Replicated), в миллисекундах.

​
Пример

Query
SELECT * FROM system.clusters LIMIT 2 FORMAT Vertical;
Response
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

​
См. также

Последнее изменение 25 июня 2026 г.