메인 콘텐츠로 건너뛰기

설명

로컬 서버에 있는 복제된 테이블(Replicated Table)의 정보와 상태가 포함되어 있습니다. 이 테이블은 모니터링에 사용할 수 있습니다. 이 테이블에는 각 Replicated* 테이블에 대해 하나의 행이 있습니다.

컬럼

  • database (String) — 데이터베이스 이름.
  • table (String) — 테이블 이름.
  • uuid (UUID) — 테이블 UUID.
  • engine (String) — 테이블 엔진 이름.
  • is_leader (UInt8) — 레플리카가 리더인지 여부입니다. 여러 레플리카가 동시에 리더일 수 있습니다. merge_tree 설정 replicated_can_become_leader를 사용하면 레플리카가 리더가 되지 못하도록 할 수 있습니다. 리더는 백그라운드 머지를 스케줄링하는 역할을 합니다. 쓰기는 리더 여부와 관계없이, 사용 가능하고 ZK에 세션이 있는 모든 레플리카에서 수행할 수 있습니다.
  • can_become_leader (UInt8) — 레플리카가 리더가 될 수 있는지 여부입니다.
  • is_readonly (UInt8) — 레플리카가 읽기 전용 모드인지 여부입니다. 이 모드는 구성에 ClickHouse Keeper 관련 섹션이 없을 때, ClickHouse Keeper에서 세션을 다시 초기화할 때 알 수 없는 오류가 발생했을 때, 그리고 ClickHouse Keeper에서 세션을 다시 초기화하는 동안 활성화됩니다.
  • readonly_start_time (Nullable(DateTime)) — 레플리카가 읽기 전용 모드로 전환된 타임스탬프입니다. 레플리카가 읽기 전용 모드가 아니면 Null입니다.
  • is_session_expired (UInt8) — ClickHouse Keeper와의 세션이 만료되었는지 여부입니다. 기본적으로 is_readonly와 같습니다.
  • future_parts (UInt32) — 아직 수행되지 않은 INSERT 또는 머지의 결과로 생성될 데이터 파트 수입니다.
  • parts_to_check (UInt32) — 검증을 위해 큐에 들어 있는 데이터 파트 수입니다. 파트가 손상되었을 가능성이 있다고 판단되면 검증 큐에 추가됩니다.
  • zookeeper_name (String) — 테이블의 메타데이터가 저장되는 [Zoo]Keeper 클러스터(보조 클러스터일 수 있음)의 이름입니다.
  • zookeeper_path (String) — ClickHouse Keeper에서 테이블 데이터의 경로입니다.
  • replica_name (String) — ClickHouse Keeper에서의 레플리카 이름입니다. 동일한 테이블의 서로 다른 레플리카는 서로 다른 이름을 가집니다.
  • replica_path (String) — ClickHouse Keeper에서의 레플리카 데이터 경로입니다. ‘zookeeper_path/replicas/replica_path’를 연결한 것과 같습니다.
  • columns_version (Int32) — 테이블 구조의 버전 번호입니다. ALTER가 몇 번 수행되었는지를 나타냅니다. 레플리카 간 버전이 다르면 일부 레플리카가 아직 모든 ALTER를 수행하지 않았음을 의미합니다.
  • queue_size (UInt32) — 수행 대기 중인 작업의 큐 크기입니다. 작업에는 데이터 블록 삽입, 머지, 그리고 일부 기타 작업이 포함됩니다. 보통 future_parts와 일치합니다.
  • inserts_in_queue (UInt32) — 수행해야 하는 데이터 블록 삽입 수입니다. 삽입은 일반적으로 매우 빠르게 복제됩니다. 이 값이 크면 문제가 있음을 의미합니다.
  • merges_in_queue (UInt32) — 수행 대기 중인 머지 수입니다. 머지는 오래 걸릴 수 있으므로 이 값이 오랫동안 0보다 클 수 있습니다.
  • part_mutations_in_queue (UInt32) — 수행 대기 중인 뮤테이션 수입니다.
  • queue_oldest_time (DateTime) — queue_size가 0보다 크면 가장 오래된 작업이 큐에 추가된 시점을 표시합니다.
  • inserts_oldest_time (DateTime) — queue_oldest_time를 참조하십시오.
  • merges_oldest_time (DateTime) — queue_oldest_time를 참조하십시오.
  • part_mutations_oldest_time (DateTime) — queue_oldest_time를 참조하십시오.
  • oldest_part_to_get (String) — 복제 큐에서 가장 오래된 GET_PARTS 항목을 기준으로, 다른 레플리카에서 가져와야 할 파트의 이름입니다.
  • oldest_part_to_merge_to (String) — 복제 큐에서 가장 오래된 MERGE_PARTS 항목으로부터 얻은, 머지된 결과 파트 이름입니다.
  • oldest_part_to_mutate_to (String) — 복제 큐에서 가장 오래된 MUTATE_PARTS 항목으로부터 얻은, 변경된 결과 파트 이름입니다.
  • log_max_index (UInt64) — 일반 활동 로그의 최대 항목 번호입니다. 이 컬럼과 다음 3개(log_pointer, total_replicas, active_replicas)는 ClickHouse Keeper에 활성 세션이 있을 때만 0이 아닌 값을 가집니다.
  • log_pointer (UInt64) — 레플리카가 실행 큐에 복사한 일반 활동 로그의 최대 항목 번호에 1을 더한 값입니다. log_pointer가 log_max_index보다 훨씬 작다면 문제가 있는 것입니다.
  • last_queue_update (DateTime) — 큐가 마지막으로 업데이트된 시각입니다.
  • absolute_delay (UInt64) — 현재 레플리카의 초 단위 지연입니다.
  • total_replicas (UInt32) — 이 테이블에 대해 알려진 전체 레플리카 수입니다.
  • active_replicas (UInt32) — ClickHouse Keeper에 세션이 있는 이 테이블의 레플리카 수입니다(즉, 정상적으로 동작하는 레플리카 수).
  • lost_part_count (UInt64) — 테이블 생성 이후 모든 레플리카에서 손실된 데이터 파트의 총수입니다. 이 값은 ClickHouse Keeper에 영속적으로 저장되며 증가만 할 수 있습니다.
  • last_queue_update_exception (String) — 큐에 손상된 항목이 있을 때의 예외입니다. 특히 ClickHouse가 버전 간 하위 호환성을 깨뜨려, 더 최신 버전이 기록한 로그 항목을 이전 버전에서 해석할 수 없을 때 중요합니다.
  • zookeeper_exception (String) — ClickHouse Keeper에서 정보를 가져오는 중 오류가 발생했을 때 얻는 마지막 예외 메시지입니다.
  • replica_is_active (Map(String, UInt8)) — 레플리카 이름과 해당 레플리카의 활성 여부를 나타내는 맵입니다.

예시

SELECT *
FROM system.replicas
WHERE table = 'test_table'
FORMAT Vertical
Query id: dc6dcbcb-dc28-4df9-ae27-4354f5b3b13e

Row 1:
───────
database:                    db
table:                       test_table
engine:                      ReplicatedMergeTree
is_leader:                   1
can_become_leader:           1
is_readonly:                 0
is_session_expired:          0
future_parts:                0
parts_to_check:              0
zookeeper_path:              /test/test_table
replica_name:                r1
replica_path:                /test/test_table/replicas/r1
columns_version:             -1
queue_size:                  27
inserts_in_queue:            27
merges_in_queue:             0
part_mutations_in_queue:     0
queue_oldest_time:           2021-10-12 14:48:48
inserts_oldest_time:         2021-10-12 14:48:48
merges_oldest_time:          1970-01-01 03:00:00
part_mutations_oldest_time:  1970-01-01 03:00:00
oldest_part_to_get:          1_17_17_0
oldest_part_to_merge_to:
oldest_part_to_mutate_to:
log_max_index:               206
log_pointer:                 207
last_queue_update:           2021-10-12 14:50:08
absolute_delay:              99
total_replicas:              5
active_replicas:             5
lost_part_count:             0
last_queue_update_exception:
zookeeper_exception:
replica_is_active:           {'r1':1,'r2':1}
마지막 수정일 2026년 6월 25일