system.fail_points - ClickHouse Documentation

描述

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

最后修改于 2026年9月26日