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

> 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.

# system.replicas

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

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\*.

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

* `database` ([String](/fr/reference/data-types/string)) — Nom de la base de données.
* `table` ([String](/fr/reference/data-types/string)) — Nom de la table.
* `uuid` ([UUID](/fr/reference/data-types/uuid)) — UUID de la table.
* `engine` ([String](/fr/reference/data-types/string)) — Nom du moteur de table.
* `is_leader` ([UInt8](/fr/reference/data-types/int-uint)) — Indique si la réplique est leader. Plusieurs répliques peuvent être leaders simultanément. Il est possible d'empêcher une réplique de devenir leader à l'aide du paramètre MergeTree `replicated&#95;can&#95;become&#95;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 disposant d'une session dans ZK, qu'elle soit leader ou non.
* `can_become_leader` ([UInt8](/fr/reference/data-types/int-uint)) — Indique si la réplique peut devenir leader.
* `is_readonly` ([UInt8](/fr/reference/data-types/int-uint)) — Indique si la réplique est en mode lecture seule. Ce mode est activé si la configuration ne comporte pas de sections ClickHouse Keeper, si une erreur inconnue survient lors de la réinitialisation des sessions dans ClickHouse Keeper, ou pendant cette réinitialisation.
* `readonly_start_time` ([Nullable(DateTime)](/fr/reference/data-types/nullable)) — Horodatage auquel la réplique est passée en mode lecture seule. NULL si la réplique n'est pas en mode lecture seule.
* `is_session_expired` ([UInt8](/fr/reference/data-types/int-uint)) — Indique si la session avec ClickHouse Keeper a expiré. Équivaut essentiellement à `is_readonly`.
* `future_parts` ([UInt32](/fr/reference/data-types/int-uint)) — 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](/fr/reference/data-types/int-uint)) — Nombre de parties de données dans la file d'attente de vérification. Une partie est placée dans cette file si l'on soupçonne qu'elle pourrait être endommagée.
* `zookeeper_name` ([String](/fr/reference/data-types/string)) — Nom du cluster \[Zoo]Keeper (éventuellement auxiliaire) dans lequel sont stockées les métadonnées de la table.
* `zookeeper_path` ([String](/fr/reference/data-types/string)) — Chemin vers les données de la table dans ClickHouse Keeper.
* `replica_name` ([String](/fr/reference/data-types/string)) — Nom de la réplique dans ClickHouse Keeper. Les répliques d'une même table ont des noms différents.
* `replica_path` ([String](/fr/reference/data-types/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](/fr/reference/data-types/int-uint)) — Numéro de version de la structure de la table. Indique le nombre d'exécutions d'ALTER. Si les répliques ont des versions différentes, cela signifie que certaines n'ont pas encore exécuté tous les ALTER.
* `queue_size` ([UInt32](/fr/reference/data-types/int-uint)) — 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. Elle coïncide généralement avec `future&#95;parts`.
* `inserts_in_queue` ([UInt32](/fr/reference/data-types/int-uint)) — 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 indique un problème.
* `merges_in_queue` ([UInt32](/fr/reference/data-types/int-uint)) — 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](/fr/reference/data-types/int-uint)) — Nombre de mutations en attente d'exécution.
* `queue_oldest_time` ([DateTime](/fr/reference/data-types/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](/fr/reference/data-types/datetime)) — Voir `queue_oldest_time`.
* `merges_oldest_time` ([DateTime](/fr/reference/data-types/datetime)) — Voir `queue_oldest_time`.
* `part_mutations_oldest_time` ([DateTime](/fr/reference/data-types/datetime)) — Voir `queue_oldest_time`.
* `oldest_part_to_get` ([String](/fr/reference/data-types/string)) — Nom de la partie à récupérer auprès d'autres répliques, obtenu à partir de l'entrée GET\_PARTS la plus ancienne de la file d'attente de réplication.
* `oldest_part_to_merge_to` ([String](/fr/reference/data-types/string)) — Nom de la partie résultante dans laquelle fusionner, obtenu à partir de l’entrée MERGE\_PARTS la plus ancienne de la file de réplication.
* `oldest_part_to_mutate_to` ([String](/fr/reference/data-types/string)) — Nom de la partie résultante à muter, obtenu à partir de l’entrée MUTATE\_PARTS la plus ancienne de la file de réplication.
* `log_max_index` ([UInt64](/fr/reference/data-types/int-uint)) — Numéro maximal d’entrée 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’une session active avec ClickHouse Keeper existe.
* `log_pointer` ([UInt64](/fr/reference/data-types/int-uint)) — Numéro maximal d’entrée dans le journal d’activité général que la réplique a copiée dans sa file d’exécution, plus un. Si log\_pointer est nettement inférieur à log\_max\_index, un problème est survenu.
* `last_queue_update` ([DateTime](/fr/reference/data-types/datetime)) — Date de la dernière mise à jour de la file.
* `absolute_delay` ([UInt64](/fr/reference/data-types/int-uint)) — Retard de la réplique actuelle, en secondes.
* `total_replicas` ([UInt32](/fr/reference/data-types/int-uint)) — Nombre total de répliques connues de cette table.
* `active_replicas` ([UInt32](/fr/reference/data-types/int-uint)) — Nombre de répliques de cette table ayant une session dans ClickHouse Keeper (c’est-à-dire le nombre de répliques opérationnelles).
* `lost_part_count` ([UInt64](/fr/reference/data-types/int-uint)) — Nombre total de parties de données perdues dans la table par l’ensemble des répliques depuis la création de la table. Cette valeur est conservée dans ClickHouse Keeper et ne peut qu’augmenter.
* `last_queue_update_exception` ([String](/fr/reference/data-types/string)) — Indique que la file contient des entrées défectueuses. Particulièrement important lorsque ClickHouse rompt la compatibilité descendante entre les versions et que les entrées de journal écrites par des versions plus récentes ne peuvent pas être analysées par les versions plus anciennes.
* `zookeeper_exception` ([String](/fr/reference/data-types/string)) — 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)](/fr/reference/data-types/map)) — Mappage entre le nom d’une réplique et son état d’activité.

**Alias :**

* `readonly_duration` — alias de `if(isNull(readonly_start_time), NULL, now() - readonly_start_time)`.

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

```sql theme={null}
SELECT *
FROM system.replicas
WHERE table = 'test_table'
FORMAT Vertical
```

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