> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

# system.clusters

<div id="description">
  ## Descrição
</div>

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

<div id="Columns">
  ## Colunas
</div>

* `cluster` ([String](/pt-BR/reference/data-types)) — O nome do cluster.
* `shard_num` ([UInt32](/pt-BR/reference/data-types)) — O número do shard no cluster, começando em 1.
* `shard_name` ([String](/pt-BR/reference/data-types)) — O nome do shard no cluster.
* `shard_weight` ([UInt32](/pt-BR/reference/data-types)) — O peso relativo do shard ao gravar dados.
* `internal_replication` ([UInt8](/pt-BR/reference/data-types)) — Sinalizador que indica se este host faz parte de um conjunto que pode replicar os dados por conta própria.
* `replica_num` ([UInt32](/pt-BR/reference/data-types)) — O número da réplica no shard, começando em 1.
* `host_name` ([String](/pt-BR/reference/data-types)) — O nome do host, conforme especificado na configuração.
* `host_address` ([String](/pt-BR/reference/data-types)) — O endereço IP do host obtido via DNS.
* `port` ([UInt16](/pt-BR/reference/data-types)) — A porta a ser usada para se conectar ao servidor.
* `is_local` ([UInt8](/pt-BR/reference/data-types)) — Sinalizador que indica se o host é local.
* `user` ([String](/pt-BR/reference/data-types)) — O nome do usuário para se conectar ao servidor.
* `default_database` ([String](/pt-BR/reference/data-types)) — O nome do banco de dados padrão.
* `errors_count` ([UInt32](/pt-BR/reference/data-types)) — O número de vezes que este host não conseguiu alcançar a réplica.
* `slowdowns_count` ([UInt32](/pt-BR/reference/data-types)) — 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](/pt-BR/reference/data-types)) — Segundos restantes até que a contagem de erros da réplica seja zerada e ela volte a ser considerada normal.
* `database_shard_name` ([String](/pt-BR/reference/data-types)) — O nome do shard do banco de dados `Replicated` (para clusters que pertencem a um banco de dados `Replicated`).
* `database_replica_name` ([String](/pt-BR/reference/data-types)) — 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](/pt-BR/reference/data-types)) — Bool que indica se o cluster pertence ao Shared Catalog.
* `is_active` ([Nullable(UInt8)](/pt-BR/reference/data-types)) — 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)](/pt-BR/reference/data-types)) — Indica se uma réplica do banco de dados `Replicated` tem atraso de replicação maior que max\_replication\_lag\_to\_enqueue após a criação ou a recuperação da réplica.
* `replication_lag` ([Nullable(UInt32)](/pt-BR/reference/data-types)) — O atraso 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)](/pt-BR/reference/data-types)) — 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.

<div id="example">
  ## Exemplo
</div>

```sql title="Query" theme={null}
SELECT * FROM system.clusters LIMIT 2 FORMAT Vertical;
```

```text title="Response" theme={null}
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
```

<div id="see-also">
  ## Veja também
</div>

* [motor de tabela Distributed](/pt-BR/reference/engines/table-engines/special/distributed)
* [configuração distributed\_replica\_error\_cap](/pt-BR/reference/settings/session-settings#distributed_replica_error_cap)
* [configuração distributed\_replica\_error\_half\_life](/pt-BR/reference/settings/session-settings#distributed_replica_error_half_life)