system.clusters

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.

​

Description

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

​

Colonnes

• cluster (String) — Le nom du cluster.
• shard_num (UInt32) — Le numéro du segment dans le cluster, à partir de 1.
• shard_name (String) — Le nom du segment dans le cluster.
• shard_weight (UInt32) — Le poids relatif du segment lors de l’écriture des données.
• internal_replication (UInt8) — Indicateur précisant si cet hôte fait partie d’un ensemble capable de répliquer les données de manière autonome.
• replica_num (UInt32) — Le numéro de la réplique dans le segment, à partir de 1.
• host_name (String) — Le nom d’hôte, tel que spécifié dans la config.
• host_address (String) — L’adresse IP de l’hôte obtenue via DNS.
• port (UInt16) — Le port à utiliser pour se connecter au serveur.
• is_local (UInt8) — Indicateur précisant si l’hôte est local.
• user (String) — Le nom de l’utilisateur permettant de se connecter au serveur.
• default_database (String) — Le nom de la base de données par défaut.
• errors_count (UInt32) — Le nombre de fois où cet hôte n’a pas réussi à joindre la réplique.
• slowdowns_count (UInt32) — 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) — Nombre de secondes restantes avant que le nombre d’erreurs de la réplique soit remis à zéro et qu’elle soit considérée comme revenue à la normale.
• database_shard_name (String) — Le nom du segment de la base de données Replicated (pour les clusters appartenant à une base de données Replicated).
• database_replica_name (String) — Le nom de la réplique de la base de données Replicated (pour les clusters appartenant à une base de données Replicated).
• is_shared_catalog_cluster (UInt8) — Bool indiquant si le cluster appartient au Shared Catalog.
• is_active (Nullable(UInt8)) — Le statut de la réplique de la base de données Replicated (pour les clusters appartenant à 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)) — 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 sa création ou sa récupération.
• replication_lag (Nullable(UInt32)) — Le retard de réplication de la réplique de la base de données Replicated (pour les clusters appartenant à une base de données Replicated).
• recovery_time (Nullable(UInt64)) — Le temps de récupération de la réplique de la base de données Replicated (pour les clusters appartenant à une base de données Replicated), en millisecondes.

Alias :

• name — alias de cluster.

​

Exemple

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

​

Voir aussi

• Moteur de table Distributed
• paramètre distributed_replica_error_cap
• paramètre distributed_replica_error_half_life