Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

system.clusters

View as MarkdownEdit this pageReport an issueSet up docs MCP

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

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

Navigation