Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

system.clusters

View as MarkdownEdit this pageReport an issueSet up docs MCP

描述

包含配置文件中可用集群及其服务器的信息。

列

  • 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) — 副本错误计数归零并被视为恢复正常前的剩余秒数。
  • database_shard_name (String) — Replicated 数据库 сегмент 的名称 (适用于属于 Replicated 数据库的集群) 。
  • database_replica_name (String) — Replicated 数据库副本的名称 (适用于属于 Replicated 数据库的集群) 。
  • is_shared_catalog_cluster (UInt8) — Bool，指示集群是否属于 Shared Catalog。
  • 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 数据库的集群) ，单位为毫秒。

别名：

  • name — cluster 的别名。

示例

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