Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

system.clusters

설명

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

컬럼

  • 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 데이터베이스에 속한 클러스터에 해당).

별칭:

  • namecluster의 별칭입니다.

예시

Querysql
SELECT * FROM system.clusters LIMIT 2 FORMAT Vertical;
Responsetext
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

관련 항목

Navigation