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

> Tabela de sistema que contém informações e o status das tabelas replicadas armazenadas no servidor local. Útil para monitoramento.

# system.replicas

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

Contém informações e o status das tabelas replicadas no servidor local.
Esta tabela pode ser usada para monitoramento. A tabela contém uma linha para cada tabela Replicated\*.

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

* `database` ([String](/pt-BR/reference/data-types/string)) — Nome do banco de dados.
* `table` ([String](/pt-BR/reference/data-types/string)) — Nome da tabela.
* `uuid` ([UUID](/pt-BR/reference/data-types/uuid)) — UUID da tabela.
* `engine` ([String](/pt-BR/reference/data-types/string)) — Nome do mecanismo de tabela.
* `is_leader` ([UInt8](/pt-BR/reference/data-types/int-uint)) — Indica se a réplica é líder. Várias réplicas podem ser líderes ao mesmo tempo. É possível impedir que uma réplica se torne líder usando a configuração merge\_tree replicated\_can\_become\_leader. Os líderes são responsáveis pelo agendamento de mesclagens em segundo plano. Observe que é possível realizar gravações em qualquer réplica disponível que tenha uma sessão no ZK, independentemente de ser líder.
* `can_become_leader` ([UInt8](/pt-BR/reference/data-types/int-uint)) — Indica se a réplica pode ser líder.
* `is_readonly` ([UInt8](/pt-BR/reference/data-types/int-uint)) — Indica se a réplica está no modo somente leitura. Esse modo é ativado se a configuração não contiver seções do ClickHouse Keeper, se ocorrer um erro desconhecido ao reinicializar sessões no ClickHouse Keeper ou durante a reinicialização de sessões no ClickHouse Keeper.
* `readonly_start_time` ([Nullable(DateTime)](/pt-BR/reference/data-types/nullable)) — O timestamp em que a réplica entrou no modo somente leitura. Nulo se a réplica não estiver nesse modo.
* `is_session_expired` ([UInt8](/pt-BR/reference/data-types/int-uint)) — Indica se a sessão com o ClickHouse Keeper expirou. Basicamente, o mesmo que `is_readonly`.
* `future_parts` ([UInt32](/pt-BR/reference/data-types/int-uint)) — O número de partes de dados que surgirão como resultado de INSERTs ou mesclagens que ainda não foram realizadas.
* `parts_to_check` ([UInt32](/pt-BR/reference/data-types/int-uint)) — O número de partes de dados na fila de verificação. Uma parte é colocada nessa fila se houver suspeita de que esteja danificada.
* `zookeeper_name` ([String](/pt-BR/reference/data-types/string)) — O nome do cluster \[Zoo]Keeper, possivelmente auxiliar, onde os metadados da tabela estão armazenados.
* `zookeeper_path` ([String](/pt-BR/reference/data-types/string)) — Caminho para os dados da tabela no ClickHouse Keeper.
* `replica_name` ([String](/pt-BR/reference/data-types/string)) — Nome da réplica no ClickHouse Keeper. Réplicas diferentes da mesma tabela têm nomes diferentes.
* `replica_path` ([String](/pt-BR/reference/data-types/string)) — Caminho para os dados da réplica no ClickHouse Keeper. Equivale à concatenação de 'zookeeper\_path/replicas/replica\_path'.
* `columns_version` ([Int32](/pt-BR/reference/data-types/int-uint)) — Número da versão da estrutura da tabela. Indica quantas vezes ALTER foi executado. Se as réplicas tiverem versões diferentes, isso significa que algumas delas ainda não executaram todos os ALTERs.
* `queue_size` ([UInt32](/pt-BR/reference/data-types/int-uint)) — Tamanho da fila de operações que aguardam execução. As operações incluem inserção de blocos de dados, mesclagens e determinadas outras ações. Geralmente coincide com future\_parts.
* `inserts_in_queue` ([UInt32](/pt-BR/reference/data-types/int-uint)) — Número de inserções de blocos de dados que precisam ser realizadas. As inserções geralmente são replicadas rapidamente. Se esse número for grande, há algo errado.
* `merges_in_queue` ([UInt32](/pt-BR/reference/data-types/int-uint)) — O número de mesclagens que aguardam execução. Às vezes, as mesclagens são demoradas, portanto, esse valor pode permanecer maior que zero por muito tempo.
* `part_mutations_in_queue` ([UInt32](/pt-BR/reference/data-types/int-uint)) — O número de mutações que aguardam execução.
* `queue_oldest_time` ([DateTime](/pt-BR/reference/data-types/datetime)) — Se `queue_size` for maior que 0, mostra quando a operação mais antiga foi adicionada à fila.
* `inserts_oldest_time` ([DateTime](/pt-BR/reference/data-types/datetime)) — Consulte `queue_oldest_time`.
* `merges_oldest_time` ([DateTime](/pt-BR/reference/data-types/datetime)) — Consulte `queue_oldest_time`.
* `part_mutations_oldest_time` ([DateTime](/pt-BR/reference/data-types/datetime)) — Consulte `queue_oldest_time`.
* `oldest_part_to_get` ([String](/pt-BR/reference/data-types/string)) — O nome da parte a ser obtida de outras réplicas, extraído da entrada GET\_PARTS mais antiga na fila de replicação.
* `oldest_part_to_merge_to` ([String](/pt-BR/reference/data-types/string)) — O nome da parte resultante da mesclagem, obtido da entrada MERGE\_PARTS mais antiga na fila de replicação.
* `oldest_part_to_mutate_to` ([String](/pt-BR/reference/data-types/string)) — O nome da parte resultante da mutação, obtido da entrada MUTATE\_PARTS mais antiga na fila de replicação.
* `log_max_index` ([UInt64](/pt-BR/reference/data-types/int-uint)) — O número máximo de entrada no log de atividade geral. Esta coluna e as três seguintes (`log_pointer`, `total_replicas`, `active_replicas`) têm valor diferente de zero apenas quando há uma sessão ativa com o ClickHouse Keeper.
* `log_pointer` ([UInt64](/pt-BR/reference/data-types/int-uint)) — O número máximo de entrada no log de atividade geral que a réplica copiou para sua fila de execução, mais um. Se log\_pointer for muito menor que log\_max\_index, há algum problema.
* `last_queue_update` ([DateTime](/pt-BR/reference/data-types/datetime)) — A última vez que a fila foi atualizada.
* `absolute_delay` ([UInt64](/pt-BR/reference/data-types/int-uint)) — A defasagem, em segundos, da réplica atual.
* `total_replicas` ([UInt32](/pt-BR/reference/data-types/int-uint)) — O número total de réplicas conhecidas desta tabela.
* `active_replicas` ([UInt32](/pt-BR/reference/data-types/int-uint)) — O número de réplicas desta tabela que têm uma sessão no ClickHouse Keeper (ou seja, o número de réplicas em funcionamento).
* `lost_part_count` ([UInt64](/pt-BR/reference/data-types/int-uint)) — O número total de partes de dados perdidas na tabela por todas as réplicas desde a criação da tabela. O valor é persistido no ClickHouse Keeper e só pode aumentar.
* `last_queue_update_exception` ([String](/pt-BR/reference/data-types/string)) — Indica que a fila contém entradas corrompidas. É especialmente importante quando o ClickHouse quebra a compatibilidade retroativa entre versões e as entradas de log gravadas por versões mais recentes não podem ser analisadas por versões antigas.
* `zookeeper_exception` ([String](/pt-BR/reference/data-types/string)) — A última mensagem de exceção recebida quando ocorreu um erro ao buscar informações no ClickHouse Keeper.
* `replica_is_active` ([Map(String, UInt8)](/pt-BR/reference/data-types/map)) — Map que associa o nome da réplica ao seu status de atividade.

**Aliases:**

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

<div id="example">
  ## Exemplo
</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}
```
