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

system.clusters

Описание​

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

Столбцы​

  • 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) — Количество замедлений, из-за которых при установлении соединения с использованием hedged requests происходило переключение на другую реплику.
  • estimated_recovery_time (UInt32) — Количество секунд, оставшихся до обнуления счётчика ошибок реплики, после чего она будет считаться вернувшейся в нормальное состояние.
  • database_shard_name (String) — Имя сегмента базы данных Replicated (для кластеров, принадлежащих базе данных Replicated).
  • database_replica_name (String) — Имя реплики базы данных Replicated (для кластеров, принадлежащих базе данных Replicated).
  • is_shared_catalog_cluster (UInt8) — Булево значение, указывающее, принадлежит ли кластер общему каталогу.
  • 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), в миллисекундах.

Псевдонимы:

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

Пример​

Запрос:

SELECT * FROM system.clusters LIMIT 2 FORMAT Vertical;

Результат:

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

См. также​