system.replicas

Table système contenant des informations sur les tables répliquées présentes sur le serveur local et leur état. Utile pour la supervision.

​

Description

Contient des informations et l’état des tables répliquées présentes sur le serveur local. Cette table peut être utilisée à des fins de supervision. Elle contient une ligne pour chaque table Replicated*.

​

Colonnes

• database (String) — Nom de la base de données.
• table (String) — Nom de la table.
• uuid (UUID) — UUID de la table.
• engine (String) — Nom du moteur de table.
• is_leader (UInt8) — Indique si la réplique est leader. Plusieurs répliques peuvent être leaders en même temps. Il est possible d’empêcher une réplique de devenir leader à l’aide du paramètre merge_tree replicated_can_become_leader. Les leaders sont responsables de la planification des fusions en arrière-plan. Notez que des écritures peuvent être effectuées sur n’importe quelle réplique disponible ayant une session dans ZK, qu’elle soit leader ou non.
• can_become_leader (UInt8) — Indique si la réplique peut devenir leader.
• is_readonly (UInt8) — Indique si la réplique est en mode lecture seule. Ce mode est activé si la configuration ne contient pas de sections avec ClickHouse Keeper, si une erreur inconnue s’est produite lors de la réinitialisation des sessions dans ClickHouse Keeper, ainsi que pendant la réinitialisation de session dans ClickHouse Keeper.
• readonly_start_time (Nullable(DateTime)) — Horodatage du passage de la réplique en mode lecture seule. NULL si la réplique n’est pas en mode lecture seule.
• is_session_expired (UInt8) — Indique si la session avec ClickHouse Keeper a expiré. C’est essentiellement la même chose que is_readonly.
• future_parts (UInt32) — Le nombre de parties de données qui apparaîtront à la suite d’INSERT ou de fusions qui n’ont pas encore été effectués.
• parts_to_check (UInt32) — Le nombre de parties de données dans la file d’attente de vérification. Une partie est placée dans la file d’attente de vérification s’il y a des soupçons qu’elle soit endommagée.
• zookeeper_name (String) — Le nom du cluster [Zoo]Keeper (éventuellement auxiliaire) où sont stockées les métadonnées de la table
• zookeeper_path (String) — Chemin vers les données de la table dans ClickHouse Keeper.
• replica_name (String) — Nom de la réplique dans ClickHouse Keeper. Les différentes répliques d’une même table portent des noms différents.
• replica_path (String) — Chemin vers les données de la réplique dans ClickHouse Keeper. Équivaut à la concaténation de ‘zookeeper_path/replicas/replica_path’.
• columns_version (Int32) — Numéro de version de la structure de la table. Indique combien de fois ALTER a été exécuté. Si les répliques ont des versions différentes, cela signifie que certaines répliques n’ont pas encore exécuté tous les ALTER.
• queue_size (UInt32) — Taille de la file d’attente des opérations en attente d’exécution. Ces opérations incluent l’insertion de blocs de données, les fusions et certaines autres actions. Cela correspond généralement à future_parts.
• inserts_in_queue (UInt32) — Nombre d’insertions de blocs de données à effectuer. Les insertions sont généralement répliquées assez rapidement. Si ce nombre est élevé, cela signifie que quelque chose ne va pas.
• merges_in_queue (UInt32) — Le nombre de fusions en attente d’exécution. Les fusions sont parfois longues, cette valeur peut donc rester supérieure à zéro pendant longtemps.
• part_mutations_in_queue (UInt32) — Le nombre de mutations en attente d’exécution.
• queue_oldest_time (DateTime) — Si queue_size est supérieur à 0, indique quand l’opération la plus ancienne a été ajoutée à la file d’attente.
• inserts_oldest_time (DateTime) — Voir queue_oldest_time.
• merges_oldest_time (DateTime) — Voir queue_oldest_time.
• part_mutations_oldest_time (DateTime) — Voir queue_oldest_time.
• oldest_part_to_get (String) — Le nom de la partie à récupérer depuis d’autres répliques, obtenu à partir de l’entrée GET_PARTS la plus ancienne dans la file d’attente de réplication.
• oldest_part_to_merge_to (String) — Le nom de la part résultante dans laquelle fusionner, obtenu à partir de l’entrée MERGE_PARTS la plus ancienne de la file d’attente de réplication.
• oldest_part_to_mutate_to (String) — Le nom de la part résultante vers laquelle effectuer la mutation, obtenu à partir de l’entrée MUTATE_PARTS la plus ancienne de la file d’attente de réplication.
• log_max_index (UInt64) — Le numéro d’entrée maximal dans le journal d’activité général. Cette colonne et les trois suivantes (log_pointer, total_replicas, active_replicas) n’ont une valeur non nulle que lorsqu’il existe une session active avec ClickHouse Keeper.
• log_pointer (UInt64) — Le numéro d’entrée maximal du journal d’activité général que la réplique a copié dans sa file d’exécution, plus un. Si log_pointer est nettement inférieur à log_max_index, cela indique un problème.
• last_queue_update (DateTime) — Date de la dernière mise à jour de la file d’attente.
• absolute_delay (UInt64) — Le retard actuel de la réplique, en secondes.
• total_replicas (UInt32) — Le nombre total de répliques connues pour cette table.
• active_replicas (UInt32) — Le nombre de répliques de cette table qui ont une session dans ClickHouse Keeper (c’est-à-dire le nombre de répliques fonctionnelles).
• lost_part_count (UInt64) — Le nombre total de parts de données perdues dans la table par l’ensemble des répliques depuis la création de la table. La valeur est stockée de manière persistante dans ClickHouse Keeper et ne peut qu’augmenter.
• last_queue_update_exception (String) — Indique que la file d’attente contient des entrées corrompues. C’est particulièrement important lorsque ClickHouse rompt la rétrocompatibilité entre versions et que les entrées de journal écrites par des versions plus récentes ne peuvent pas être analysées par les anciennes versions.
• zookeeper_exception (String) — Le dernier message d’exception obtenu si l’erreur s’est produite lors de la récupération des informations depuis ClickHouse Keeper.
• replica_is_active (Map(String, UInt8)) — Correspondance entre le nom de la réplique et son état d’activité.

​

Exemple

SELECT *
FROM system.replicas
WHERE table = 'test_table'
FORMAT Vertical

Query id: dc6dcbcb-dc28-4df9-ae27-4354f5b3b13e

Row 1:
───────
database:                    db
table:                       test_table
engine:                      ReplicatedMergeTree
is_leader:                   1
can_become_leader:           1
is_readonly:                 0
is_session_expired:          0
future_parts:                0
parts_to_check:              0
zookeeper_path:              /test/test_table
replica_name:                r1
replica_path:                /test/test_table/replicas/r1
columns_version:             -1
queue_size:                  27
inserts_in_queue:            27
merges_in_queue:             0
part_mutations_in_queue:     0
queue_oldest_time:           2021-10-12 14:48:48
inserts_oldest_time:         2021-10-12 14:48:48
merges_oldest_time:          1970-01-01 03:00:00
part_mutations_oldest_time:  1970-01-01 03:00:00
oldest_part_to_get:          1_17_17_0
oldest_part_to_merge_to:
oldest_part_to_mutate_to:
log_max_index:               206
log_pointer:                 207
last_queue_update:           2021-10-12 14:50:08
absolute_delay:              99
total_replicas:              5
active_replicas:             5
lost_part_count:             0
last_queue_update_exception:
zookeeper_exception:
replica_is_active:           {'r1':1,'r2':1}