system.replicas

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

​

Descrição

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

​

Colunas

• 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. Uma réplica pode ser impedida de se tornar líder usando a configuração do merge_tree replicated_can_become_leader. As líderes são responsáveis por agendar merges em segundo plano. Observe que gravações 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 ser líder.
• is_readonly (UInt8) — Indica se a réplica está em modo somente leitura. Esse modo é ativado se a config 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 em que a réplica entrou no modo readonly. NULL se a réplica não estiver no modo readonly.
• 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 merges que ainda não foram realizados.
• parts_to_check (UInt32) — O número de partes de dados na fila para verificação. Uma parte é colocada na fila de verificação se houver suspeita de que possa estar danificada.
• zookeeper_name (String) — O nome do cluster [Zoo]Keeper (possivelmente auxiliar) em que os metadados da tabela são armazenados
• zookeeper_path (String) — Caminho para os 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 diferentes.
• replica_path (String) — Caminho para os dados da réplica no ClickHouse Keeper. O mesmo que concatenar ‘zookeeper_path/replicas/replica_path’.
• columns_version (Int32) — 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 réplicas ainda não executaram todos os ALTERs.
• queue_size (UInt32) — Tamanho da fila de operações aguardando execução. As operações incluem inserção de blocos de dados, merges e certas outras ações. Geralmente coincide com future_parts.
• inserts_in_queue (UInt32) — Número de inserts de blocos de dados que precisam ser feitos. As inserções geralmente são replicadas com bastante rapidez. Se esse número for grande, significa que algo está errado.
• merges_in_queue (UInt32) — O número de merges aguardando para serem feitos. Às vezes, os merges são demorados, então esse valor pode permanecer maior que zero por muito tempo.
• part_mutations_in_queue (UInt32) — O número de mutações aguardando para serem feitas.
• queue_oldest_time (DateTime) — Se queue_size for maior que 0, mostra quando a operação mais antiga foi adicionada à fila.
• inserts_oldest_time (DateTime) — Veja queue_oldest_time.
• merges_oldest_time (DateTime) — Veja queue_oldest_time.
• part_mutations_oldest_time (DateTime) — Veja queue_oldest_time.
• oldest_part_to_get (String) — O nome da parte a ser buscada em 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 resultante para a qual fazer o merge, obtido da entrada MERGE_PARTS mais antiga na fila de replicação.
• oldest_part_to_mutate_to (String) — O nome da parte resultante para a qual aplicar a mutação, obtido da entrada MUTATE_PARTS mais antiga na fila de replicação.
• log_max_index (UInt64) — 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) — 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, algo está errado.
• last_queue_update (DateTime) — Quando a fila foi atualizada pela última vez.
• absolute_delay (UInt64) — O tamanho da defasagem, em segundos, da réplica atual.
• total_replicas (UInt32) — O número total de réplicas conhecidas desta tabela.
• active_replicas (UInt32) — 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) — 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) — Quando a fila contém entradas corrompidas. Isso é especialmente importante quando o ClickHouse quebra a compatibilidade retroativa 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 as informações no ClickHouse Keeper.
• replica_is_active (Map(String, UInt8)) — Map entre o nome da réplica e se a réplica está ativa.

​

Exemplo

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}