system.fail_points

Contiene una lista de todos los failpoints disponibles, con su tipo y estado actuales.

​

Descripción

Contiene una lista de todos los failpoints disponibles registrados en el servidor, junto con su tipo y si están habilitados actualmente.

En builds con soporte para failpoints (USE_LIBFIU=1), los failpoints se pueden habilitar y deshabilitar en tiempo de ejecución mediante las sentencias SYSTEM ENABLE FAILPOINT y SYSTEM DISABLE FAILPOINT. Estas sentencias no están disponibles en builds sin soporte para failpoints, aunque la tabla sigue estando disponible.

SYSTEM DISABLE ALL FAILPOINTS deshabilita todos los failpoints a la vez y reanuda cualquier hilo bloqueado en uno que admita pausa, lo que resulta útil para devolver un servidor a un estado limpio sin necesidad de saber cuáles están habilitados actualmente.

​

Columnas

• name (String) — Nombre del failpoint.
• type (Enum8(‘once’ = 0, ‘regular’ = 1, ‘pauseable_once’ = 2, ‘pauseable’ = 3)) — Tipo de failpoint: ‘once’ se activa una sola vez y luego se deshabilita automáticamente; ‘regular’ se activa cada vez; ‘pauseable_once’ bloquea la ejecución una vez; ‘pauseable’ bloquea la ejecución cada vez hasta que se reanuda.
• enabled (UInt8) — Indica si el failpoint está habilitado (1) o deshabilitado (0).

​

Ejemplo

Este ejemplo requiere un build con soporte de failpoint (USE_LIBFIU=1).

Query

SYSTEM ENABLE FAILPOINT replicated_merge_tree_insert_retry_pause;
SELECT * FROM system.fail_points WHERE enabled = 1

Response

┌─name──────────────────────────────────────┬─type────────────┬─enabled─┐
│ replicated_merge_tree_insert_retry_pause  │ pauseable_once  │       1 │
└───────────────────────────────────────────┴─────────────────┴─────────┘