system.fail_points

Contient la liste de tous les failpoints disponibles avec leur type et leur état actuel.

​

Description

Contient la liste de tous les failpoints disponibles enregistrés sur le serveur, ainsi que leur type et leur état d’activation actuel.

Dans les builds prenant en charge les failpoints (USE_LIBFIU=1), les failpoints peuvent être activés et désactivés au moment de l’exécution à l’aide des instructions SYSTEM ENABLE FAILPOINT et SYSTEM DISABLE FAILPOINT. Ces instructions ne sont pas disponibles dans les builds dépourvus de prise en charge des failpoints, bien que la table reste disponible.

SYSTEM DISABLE ALL FAILPOINTS désactive tous les failpoints en une seule fois et débloque tout thread en attente sur un failpoint de type pause, ce qui permet de ramener un serveur à un état propre sans avoir à connaître ceux qui sont actuellement activés.

​

Colonnes

• name (String) — Nom du failpoint.
• type (Enum8(‘once’ = 0, ‘regular’ = 1, ‘pauseable_once’ = 2, ‘pauseable’ = 3)) — Type de failpoint : ‘once’ se déclenche une seule fois puis se désactive automatiquement, ‘regular’ se déclenche à chaque fois, ‘pauseable_once’ bloque l’exécution une seule fois, ‘pauseable’ bloque l’exécution à chaque fois jusqu’à ce qu’elle reprenne.
• enabled (UInt8) — Indique si le failpoint est actuellement activé (1) ou désactivé (0).

​

Exemple

Cet exemple nécessite un build prenant en charge les failpoints (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 │
└───────────────────────────────────────────┴─────────────────┴─────────┘