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

> Table système contenant des informations sur les clusters disponibles dans le fichier de configuration ainsi que sur les serveurs qui y sont définis.

# system.clusters

<div id="description">
  ## Description
</div>

Contient des informations sur les clusters disponibles dans le fichier de configuration et sur les serveurs qui les composent.

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

* `cluster` ([String](/fr/reference/data-types/index)) — Le nom du cluster.
* `shard_num` ([UInt32](/fr/reference/data-types/index)) — Le numéro du shard dans le cluster, à partir de 1.
* `shard_name` ([String](/fr/reference/data-types/index)) — Le nom du shard dans le cluster.
* `shard_weight` ([UInt32](/fr/reference/data-types/index)) — Le poids relatif du shard lors de l’écriture des données.
* `internal_replication` ([UInt8](/fr/reference/data-types/index)) — Indicateur signalant si cet hôte fait partie d’un ensemble capable de répliquer les données de manière autonome.
* `replica_num` ([UInt32](/fr/reference/data-types/index)) — Le numéro de la réplique dans le shard, à partir de 1.
* `host_name` ([String](/fr/reference/data-types/index)) — Le nom d’hôte, tel qu’il est spécifié dans la configuration.
* `host_address` ([String](/fr/reference/data-types/index)) — L’adresse IP de l’hôte obtenue via DNS.
* `port` ([UInt16](/fr/reference/data-types/index)) — Le port à utiliser pour se connecter au serveur.
* `is_local` ([UInt8](/fr/reference/data-types/index)) — Indicateur signalant si l’hôte est local.
* `user` ([String](/fr/reference/data-types/index)) — Le nom de l’utilisateur à utiliser pour se connecter au serveur.
* `default_database` ([String](/fr/reference/data-types/index)) — Le nom de la base de données par défaut.
* `errors_count` ([UInt32](/fr/reference/data-types/index)) — Le nombre de fois où cet hôte n’a pas réussi à joindre la réplique.
* `slowdowns_count` ([UInt32](/fr/reference/data-types/index)) — Le nombre de ralentissements ayant entraîné un changement de réplique lors de l’établissement d’une connexion avec des requêtes hedged.
* `estimated_recovery_time` ([UInt32](/fr/reference/data-types/index)) — Le nombre de secondes restantes avant que le compteur d’erreurs de la réplique soit remis à zéro et qu’elle soit de nouveau considérée comme normale.
* `database_shard_name` ([String](/fr/reference/data-types/index)) — Le nom du shard de la base de données `Replicated` (pour les clusters qui appartiennent à une base de données `Replicated`).
* `database_replica_name` ([String](/fr/reference/data-types/index)) — Le nom de la réplique de la base de données `Replicated` (pour les clusters qui appartiennent à une base de données `Replicated`).
* `is_shared_catalog_cluster` ([UInt8](/fr/reference/data-types/index)) — Bool indiquant si le cluster appartient au catalogue partagé.
* `is_active` ([Nullable(UInt8)](/fr/reference/data-types/index)) — L’état de la réplique de base de données Replicated (pour les clusters qui appartiennent à une base de données Replicated) : 1 signifie 'la réplique est en ligne', 0 signifie 'la réplique est hors ligne', NULL signifie 'inconnu'.
* `unsynced_after_recovery` ([Nullable(UInt8)](/fr/reference/data-types/index)) — Indique si une réplique de base de données Replicated présente un retard de réplication supérieur à max\_replication\_lag\_to\_enqueue après la création ou la récupération de la réplique.
* `replication_lag` ([Nullable(UInt32)](/fr/reference/data-types/index)) — Le retard de réplication de la réplique de base de données `Replicated` (pour les clusters qui appartiennent à une base de données Replicated).
* `recovery_time` ([Nullable(UInt64)](/fr/reference/data-types/index)) — Le temps de récupération de la réplique de base de données `Replicated` (pour les clusters qui appartiennent à une base de données Replicated), en millisecondes.

<div id="example">
  ## Exemple
</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">
  ## Voir aussi
</div>

* [Moteur de table Distributed](/fr/reference/engines/table-engines/special/distributed)
* [paramètre distributed\_replica\_error\_cap](/fr/reference/settings/session-settings#distributed_replica_error_cap)
* [paramètre distributed\_replica\_error\_half\_life](/fr/reference/settings/session-settings#distributed_replica_error_half_life)