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

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) запросами.
  • 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 — «replica is online», 0 — «replica is offline», NULL — «unknown».
  • unsynced_after_recovery (Nullable(UInt8)) — Показывает, имеет ли реплика базы данных Replicated отставание репликации больше, чем max_replication_lag_to_enqueue после создания или восстановления реплики.
  • replication_lag (Nullable(UInt32)) — Отставание репликации реплики базы данных Replicated (для кластеров, которые принадлежат базе данных Replicated).
  • recovery_time (Nullable(UInt64)) — Время восстановления реплики базы данных Replicated (для кластеров, которые принадлежат базе данных Replicated), в миллисекундах.

Пример

Запрос:

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

Строка 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


**См. также**

- [Движок таблиц Distributed](../../engines/table-engines/special/distributed.md)
- [Настройка distributed_replica_error_cap](../../operations/settings/settings.md#distributed_replica_error_cap)
- [Настройка distributed_replica_error_half_life](../../operations/settings/settings.md#distributed_replica_error_half_life)