메인 콘텐츠로 건너뛰기

설명

로컬 서버에 있는 복제된 테이블(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) — 레플리카가 읽기 전용 모드인지 여부입니다. 이 모드는 config에 ClickHouse Keeper 관련 섹션이 없거나, ClickHouse Keeper에서 세션을 재초기화할 때 알 수 없는 오류가 발생했거나, ClickHouse Keeper에서 세션을 재초기화하는 동안 활성화됩니다.
  • readonly_start_time (Nullable(DateTime)) — 레플리카가 readonly 모드로 전환된 시각입니다. 레플리카가 readonly 모드가 아니면 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 항목에서 가져온, 다른 레플리카에서 fetch할 파트의 이름입니다.
  • 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월 10일