메인 콘텐츠로 건너뛰기

설명

구성 파일에서 사용할 수 있는 클러스터와 해당 클러스터에 속한 서버 정보를 포함합니다.

컬럼

  • cluster (String) — 클러스터 이름입니다.
  • shard_num (UInt32) — 클러스터 내 세그먼트 번호이며 1부터 시작합니다.
  • shard_name (String) — 클러스터 내 세그먼트 이름입니다.
  • shard_weight (UInt32) — 데이터를 쓸 때 세그먼트의 상대 가중치입니다.
  • internal_replication (UInt8) — 이 호스트가 자체적으로 데이터를 복제할 수 있는 앙상블의 일부인지 나타내는 플래그입니다.
  • replica_num (UInt32) — 세그먼트 내 레플리카 번호이며 1부터 시작합니다.
  • host_name (String) — 구성에 지정된 호스트 이름입니다.
  • host_address (String) — DNS에서 얻은 호스트 IP 주소입니다.
  • port (UInt16) — 서버에 연결할 때 사용할 포트입니다.
  • is_local (UInt8) — 호스트가 로컬 호스트인지 나타내는 플래그입니다.
  • user (String) — 서버에 연결할 때 사용할 사용자 이름입니다.
  • default_database (String) — 기본 데이터베이스 이름입니다.
  • errors_count (UInt32) — 이 호스트가 레플리카에 도달하지 못한 횟수입니다.
  • slowdowns_count (UInt32) — 헤지드 요청으로 연결을 설정할 때 레플리카 변경으로 이어진 지연 발생 횟수입니다.
  • estimated_recovery_time (UInt32) — 레플리카 오류 횟수가 0으로 초기화되어 정상 상태로 복구된 것으로 간주될 때까지 남은 시간(초)입니다.
  • database_shard_name (String) — Replicated 데이터베이스 세그먼트의 이름입니다(Replicated 데이터베이스에 속한 클러스터의 경우).
  • database_replica_name (String) — Replicated 데이터베이스 레플리카의 이름입니다(Replicated 데이터베이스에 속한 클러스터의 경우).
  • is_shared_catalog_cluster (UInt8) — 클러스터가 Shared Catalog에 속하는지 나타내는 Bool 값입니다.
  • is_active (Nullable(UInt8)) — Replicated 데이터베이스 레플리카의 상태입니다(Replicated 데이터베이스에 속한 클러스터의 경우). 1은 ‘레플리카가 온라인 상태’, 0은 ‘레플리카가 오프라인 상태’, NULL은 ‘알 수 없음’을 의미합니다.
  • unsynced_after_recovery (Nullable(UInt8)) — 레플리카를 생성하거나 복구한 후 Replicated 데이터베이스 레플리카의 복제 지연이 max_replication_lag_to_enqueue보다 큰지 나타냅니다.
  • replication_lag (Nullable(UInt32)) — Replicated 데이터베이스 레플리카의 복제 지연입니다(Replicated 데이터베이스에 속한 클러스터의 경우).
  • recovery_time (Nullable(UInt64)) — Replicated 데이터베이스 레플리카의 복구 시간입니다(Replicated 데이터베이스에 속한 클러스터의 경우). 단위는 밀리초입니다.

예시

Query
SELECT * FROM system.clusters LIMIT 2 FORMAT Vertical;
Response
Row 1:
──────
cluster:                 test_cluster_two_shards
shard_num:               1
shard_name:              shard_01
shard_weight:            1
replica_num:             1
host_name:               127.0.0.1
host_address:            127.0.0.1
port:                    9000
is_local:                1
user:                    default
default_database:
errors_count:            0
slowdowns_count:         0
estimated_recovery_time: 0
database_shard_name:
database_replica_name:
is_active:               NULL

Row 2:
──────
cluster:                 test_cluster_two_shards
shard_num:               2
shard_name:              shard_02
shard_weight:            1
replica_num:             1
host_name:               127.0.0.2
host_address:            127.0.0.2
port:                    9000
is_local:                0
user:                    default
default_database:
errors_count:            0
slowdowns_count:         0
estimated_recovery_time: 0
database_shard_name:
database_replica_name:
is_active:               NULL

관련 항목

마지막 수정일 2026년 6월 10일