system.fail_points

사용 가능한 모든 failpoint와 해당 유형 및 현재 상태 목록을 포함합니다.

​

설명

서버에 등록된 사용 가능한 모든 failpoint 목록과 각 failpoint의 유형, 현재 활성화 여부를 보여줍니다.

failpoint를 지원하는 빌드(USE_LIBFIU=1)에서는 런타임에 SYSTEM ENABLE FAILPOINT 및 SYSTEM DISABLE FAILPOINT SQL 문을 사용하여 failpoint를 활성화하거나 비활성화할 수 있습니다. failpoint를 지원하지 않는 빌드에서는 이러한 SQL 문을 사용할 수 없지만, 테이블 자체는 계속 사용할 수 있습니다.

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 │
└───────────────────────────────────────────┴─────────────────┴─────────┘