Saltar al contenido principal

​
Descripción

Contiene información sobre el estado de las tablas replicadas que se encuentran en el servidor local. Esta tabla puede utilizarse para tareas de monitorización. Contiene una fila por cada tabla Replicated*.

​
Columnas

  • database (String) — Nombre de la base de datos.
  • table (String) — Nombre de la tabla.
  • uuid (UUID) — UUID de la tabla.
  • engine (String) — Nombre del motor de la tabla.
  • is_leader (UInt8) — Indica si la réplica es líder. Varias réplicas pueden ser líderes al mismo tiempo. Se puede impedir que una réplica se convierta en líder mediante el ajuste de merge_tree replicated_can_become_leader. Las réplicas líderes son responsables de programar las fusiones en segundo plano. Tenga en cuenta que las escrituras pueden realizarse en cualquier réplica que esté disponible y tenga una sesión en ZK, independientemente de si es líder.
  • can_become_leader (UInt8) — Indica si la réplica puede ser líder.
  • is_readonly (UInt8) — Indica si la réplica está en modo de solo lectura. Este modo se activa si la configuración no incluye secciones con ClickHouse Keeper, si se produjo un error desconocido al reinicializar sesiones en ClickHouse Keeper y durante la reinicialización de sesiones en ClickHouse Keeper.
  • readonly_start_time (Nullable(DateTime)) — La marca temporal en la que la réplica pasó al modo de solo lectura. NULL si la réplica no está en modo de solo lectura.
  • is_session_expired (UInt8) — Indica si la sesión con ClickHouse Keeper ha expirado. Básicamente, es lo mismo que is_readonly.
  • future_parts (UInt32) — El número de partes de datos que aparecerán como resultado de INSERTs o fusiones pendientes.
  • parts_to_check (UInt32) — El número de partes de datos en la cola de verificación. Se coloca una parte en la cola de verificación si se sospecha que podría estar dañada.
  • zookeeper_name (String) — El nombre del clúster de [Zoo]Keeper (posiblemente uno auxiliar) donde se almacenan los metadatos de la tabla
  • zookeeper_path (String) — Ruta de acceso a los datos de la tabla en ClickHouse Keeper.
  • replica_name (String) — Nombre de la réplica en ClickHouse Keeper. Las réplicas de la misma tabla tienen nombres distintos.
  • replica_path (String) — Ruta de los datos de la réplica en ClickHouse Keeper. Equivale a concatenar ‘zookeeper_path/replicas/replica_path’.
  • columns_version (Int32) — Número de versión de la estructura de la tabla. Indica cuántas veces se ha ejecutado ALTER. Si las réplicas tienen versiones diferentes, significa que algunas réplicas aún no han aplicado todos los ALTER.
  • queue_size (UInt32) — Tamaño de la cola de operaciones en espera de ejecutarse. Estas operaciones incluyen la inserción de bloques de datos, las fusiones y ciertas otras acciones. Suele coincidir con future_parts.
  • inserts_in_queue (UInt32) — Número de inserciones de bloques de datos que deben realizarse. Las inserciones suelen replicarse con bastante rapidez. Si este número es alto, significa que algo va mal.
  • merges_in_queue (UInt32) — El número de fusiones pendientes de ejecutarse. A veces, las fusiones pueden tardar bastante, por lo que este valor puede ser mayor que cero durante mucho tiempo.
  • part_mutations_in_queue (UInt32) — El número de mutaciones pendientes de realizarse.
  • queue_oldest_time (DateTime) — Si queue_size es mayor que 0, muestra cuándo se añadió la operación más antigua a la cola.
  • inserts_oldest_time (DateTime) — Véase queue_oldest_time.
  • merges_oldest_time (DateTime) — Véase queue_oldest_time.
  • part_mutations_oldest_time (DateTime) — Véase queue_oldest_time.
  • oldest_part_to_get (String) — El nombre de la parte que debe obtenerse de otras réplicas, tomado de la entrada GET_PARTS más antigua de la cola de replicación.
  • oldest_part_to_merge_to (String) — El nombre de la parte resultante a la que fusionar, obtenido de la entrada MERGE_PARTS más antigua de la cola de replicación.
  • oldest_part_to_mutate_to (String) — El nombre de la parte resultante a la que se debe mutar, obtenido de la entrada MUTATE_PARTS más antigua de la cola de replicación.
  • log_max_index (UInt64) — Número máximo de entrada en el registro de actividad general. Esta columna y las tres siguientes (log_pointer, total_replicas, active_replicas) solo tienen un valor distinto de cero cuando hay una sesión activa con ClickHouse Keeper.
  • log_pointer (UInt64) — Número máximo de entrada en el registro de actividad general que la réplica copió en su cola de ejecución, más uno. Si log_pointer es mucho menor que log_max_index, algo no va bien.
  • last_queue_update (DateTime) — Fecha y hora de la última actualización de la cola.
  • absolute_delay (UInt64) — Retraso, en segundos, de la réplica actual.
  • total_replicas (UInt32) — El número total de réplicas conocidas para esta tabla.
  • active_replicas (UInt32) — El número de réplicas de esta tabla que tienen una sesión en ClickHouse Keeper (es decir, el número de réplicas en funcionamiento).
  • lost_part_count (UInt64) — El número total de partes de datos perdidas en la tabla por todas las réplicas desde la creación de la tabla. El valor se almacena de forma persistente en ClickHouse Keeper y solo puede aumentar.
  • last_queue_update_exception (String) — Cuando la cola contiene entradas dañadas. Esto es especialmente importante cuando ClickHouse rompe la compatibilidad con versiones anteriores y las entradas de registro escritas por versiones más recientes no pueden analizarse en versiones antiguas.
  • zookeeper_exception (String) — El mensaje de la última excepción, obtenido si el error se produjo al obtener la información de ClickHouse Keeper.
  • replica_is_active (Map(String, UInt8)) — Mapa entre el nombre de la réplica y si está activa.

​
Ejemplo

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 modificación el 10 de junio de 2026