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*.
database (String) — Nome do banco de dados.
table (String) — Nome da tabela.
uuid (UUID) — UUID da tabela.
engine (String) — Nome do mecanismo da tabela.
is_leader (UInt8) — Indica se a réplica é a 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 de merge_tree replicated_can_become_leader. As réplicas líderes são responsáveis por agendar mesclagens em segundo plano. Observe que operações de gravação podem ser realizadas em qualquer réplica que esteja disponível e tenha uma sessão no ZK, independentemente de ser líder.
can_become_leader (UInt8) — Indica se a réplica pode se tornar líder.
is_readonly (UInt8) — Indica se a réplica está em modo somente leitura. Esse modo é ativado se a configuração não tiver seções com ClickHouse Keeper, se ocorrer um erro desconhecido ao reinicializar sessões no ClickHouse Keeper e durante a reinicialização da sessão no ClickHouse Keeper.
readonly_start_time (Nullable(DateTime)) — O timestamp de quando a réplica entrou em modo somente leitura. NULL se a réplica não estiver em modo somente leitura.
is_session_expired (UInt8) — Indica se a sessão com o ClickHouse Keeper expirou. Basicamente, é o mesmo que is_readonly.
future_parts (UInt32) — O número de partes de dados que aparecerão como resultado de INSERTs ou mesclagens que ainda não foram concluídas.
parts_to_check (UInt32) — O número de partes de dados na fila de verificação. Uma parte de dados é colocada nessa fila se houver suspeita de que possa estar danificada.
zookeeper_name (String) — O nome do cluster [Zoo]Keeper (possivelmente auxiliar) onde os metadados da tabela ficam armazenados
zookeeper_path (String) — Caminho dos dados da tabela no ClickHouse Keeper.
replica_name (String) — Nome da réplica no ClickHouse Keeper. Réplicas diferentes da mesma tabela têm nomes distintos.
replica_path (String) — Caminho para os dados da réplica no ClickHouse Keeper. Equivale à concatenação de ‘zookeeper_path/replicas/replica_path’.
columns_version (Int32) — Número da versão da estrutura da tabela. Indica quantas vezes o ALTER foi executado. Se as réplicas tiverem versões diferentes, isso significa que algumas delas ainda não aplicaram todos os ALTERs.
queue_size (UInt32) — Tamanho da fila de operações que aguardam execução. As operações incluem a inserção de blocos de dados, mesclas e algumas outras ações. Em geral, coincide com future_parts.
inserts_in_queue (UInt32) — Número de inserções de blocos de dados que precisam ser realizadas. As inserções geralmente são replicadas bem rapidamente. Se esse número for alto, significa que há algo errado.
merges_in_queue (UInt32) — O número de merges aguardando execução. Às vezes, os merges são demorados, por isso esse valor pode permanecer acima de zero por muito tempo.
part_mutations_in_queue (UInt32) — O número de mutações que aguardam execução.
queue_oldest_time (DateTime) — Se queue_size for maior que 0, indica quando a operação mais antiga foi adicionada à fila.
inserts_oldest_time (DateTime) — Consulte queue_oldest_time.
merges_oldest_time (DateTime) — Consulte queue_oldest_time.
part_mutations_oldest_time (DateTime) — Consulte queue_oldest_time.
oldest_part_to_get (String) — O nome da parte a ser obtida de outras réplicas, obtido da entrada GET_PARTS mais antiga na fila de replicação.
oldest_part_to_merge_to (String) — O nome da parte de destino da mesclagem, obtido da entrada MERGE_PARTS mais antiga na fila de replicação.
oldest_part_to_mutate_to (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) — Número máximo da 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) — Número máximo de entrada no log de atividade geral que a réplica copiou para a fila de execução, mais um. Se log_pointer for muito menor que log_max_index, algo está errado.
last_queue_update (DateTime) — Quando a fila foi atualizada pela última vez.
absolute_delay (UInt64) — O tamanho do atraso, em segundos, da réplica atual.
total_replicas (UInt32) — O número total de réplicas conhecidas da tabela.
active_replicas (UInt32) — O número de réplicas desta tabela que mantêm uma sessão no ClickHouse Keeper (ou seja, o número de réplicas em funcionamento).
lost_part_count (UInt64) — O número total de partes de dados perdidas na tabela por todas as réplicas desde a criação da tabela. O valor é armazenado no ClickHouse Keeper e só pode aumentar.
last_queue_update_exception (String) — Quando a fila contém entradas inválidas. Isso é especialmente importante quando o ClickHouse quebra a compatibilidade com versões anteriores entre versões, e entradas de log gravadas por versões mais novas não podem ser interpretadas por versões antigas.
zookeeper_exception (String) — A última mensagem de exceção, obtida se o erro ocorreu ao buscar informações do ClickHouse Keeper.
replica_is_active (Map(String, UInt8)) — Mapa entre o nome da réplica e se ela está ativa.
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}
Última modificação em 10 de junho de 2026