system.fail_points - ClickHouse Documentation

描述

包含服务器中已注册的所有可用 failpoint 及其类型，以及当前是否启用。在支持 failpoint 的构建版本 (USE_LIBFIU=1) 中，可以在运行时使用 SYSTEM ENABLE FAILPOINT 和 SYSTEM DISABLE FAILPOINT 语句来启用或禁用 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 │
└───────────────────────────────────────────┴─────────────────┴─────────┘