system.fail_points

Содержит список всех доступных failpoint с указанием их типа и текущего статуса.

​

Описание

Содержит список всех доступных failpoint, зарегистрированных на сервере, а также их тип и сведения о том, включены ли они в данный момент.

В сборках с поддержкой failpoint (USE_LIBFIU=1) failpoint можно включать и отключать во время выполнения с помощью команд SYSTEM ENABLE FAILPOINT и SYSTEM DISABLE FAILPOINT. В сборках без поддержки failpoint эти команды недоступны, хотя сама таблица остаётся доступной.

SYSTEM DISABLE ALL FAILPOINTS отключает сразу все failpoint и возобновляет работу всех потоков, заблокированных на failpoint с возможностью паузы. Это удобно для возврата сервера в чистое состояние, когда неизвестно, что именно включено в данный момент.

​

Столбцы

• name (String) — Имя failpoint.
• type (Enum8(‘once’ = 0, ‘regular’ = 1, ‘pauseable_once’ = 2, ‘pauseable’ = 3)) — Тип failpoint: ‘once’ срабатывает один раз, после чего автоматически отключается; ‘regular’ срабатывает каждый раз; ‘pauseable_once’ один раз приостанавливает выполнение; ‘pauseable’ приостанавливает выполнение каждый раз, пока оно не будет возобновлено.
• enabled (UInt8) — Указывает, включен ли failpoint в данный момент (1) или отключен (0).

​

Пример

Для этого примера требуется сборка с поддержкой 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 │
└───────────────────────────────────────────┴─────────────────┴─────────┘