system.clusters

Tabela do sistema contendo informações sobre os clusters disponíveis no arquivo de configuração e os servidores definidos neles.

​

Descrição

Contém informações sobre os clusters disponíveis no arquivo de configuração e os servidores que fazem parte deles.

​

Colunas

• cluster (String) — O nome do cluster.
• shard_num (UInt32) — O número do shard no cluster, começando em 1.
• shard_name (String) — O nome do shard no cluster.
• shard_weight (UInt32) — O peso relativo do shard durante a gravação de dados.
• internal_replication (UInt8) — Flag que indica se este host faz parte de um ensemble capaz de replicar os dados por conta própria.
• replica_num (UInt32) — O número da réplica no shard, começando em 1.
• host_name (String) — O nome do host, conforme especificado na configuração.
• host_address (String) — O endereço IP do host obtido via DNS.
• port (UInt16) — A porta usada para conexão com o servidor.
• is_local (UInt8) — Flag que indica se o host é local.
• user (String) — O nome do usuário usado para conexão com o servidor.
• default_database (String) — O nome do banco de dados padrão.
• errors_count (UInt32) — O número de vezes que este host não conseguiu alcançar a réplica.
• slowdowns_count (UInt32) — O número de lentidões que levaram à troca de réplica ao estabelecer uma conexão com solicitações hedged.
• estimated_recovery_time (UInt32) — Segundos restantes até que a contagem de erros da réplica seja zerada e ela volte a ser considerada normal.
• database_shard_name (String) — O nome do shard do banco de dados Replicated (para clusters que pertencem a um banco de dados Replicated).
• database_replica_name (String) — O nome da réplica do banco de dados Replicated (para clusters que pertencem a um banco de dados Replicated).
• is_shared_catalog_cluster (UInt8) — Bool que indica se o cluster pertence ao catálogo compartilhado.
• is_active (Nullable(UInt8)) — O status da réplica do banco de dados Replicated (para clusters que pertencem a um banco de dados Replicated): 1 significa ‘a réplica está online’, 0 significa ‘a réplica está offline’, NULL significa ‘desconhecido’.
• unsynced_after_recovery (Nullable(UInt8)) — Indica se uma réplica do banco de dados Replicated apresenta defasagem de replicação superior a max_replication_lag_to_enqueue após ser criada ou recuperada.
• replication_lag (Nullable(UInt32)) — A defasagem de replicação da réplica do banco de dados Replicated (para clusters que pertencem a um banco de dados Replicated).
• recovery_time (Nullable(UInt64)) — O tempo de recuperação da réplica do banco de dados Replicated (para clusters que pertencem a um banco de dados Replicated), em milissegundos.

Aliases:

• name — Alias de cluster.

​

Exemplo

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

​

Veja também

• motor de tabela Distributed
• configuração distributed_replica_error_cap
• configuração distributed_replica_error_half_life