メインコンテンツへスキップ
メインコンテンツへスキップ

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) — レプリカのエラー数がリセットされ、正常と見なされるまでの残り秒数。
  • database_shard_name (String) — Replicated データベースのシャード名(Replicated データベースに属するクラスターの場合)。
  • database_replica_name (String) — Replicated データベースのレプリカ名(Replicated データベースに属するクラスターの場合)。
  • is_shared_catalog_cluster (UInt8) — クラスターが共有カタログに属しているかどうかを示すブール値。
  • is_active (Nullable(UInt8)) — Replicated データベースのレプリカのステータス(Replicated データベースに属するクラスターの場合)。1 は「replica is online」、0 は「replica is offline」、NULL は「unknown」を意味する。
  • unsynced_after_recovery (Nullable(UInt8)) — Replicated データベースのレプリカが、作成または復旧後に max_replication_lag_to_enqueue を超えるレプリケーションラグを持っているかどうかを示す。
  • replication_lag (Nullable(UInt32)) — Replicated データベースのレプリカのレプリケーションラグ(Replicated データベースに属するクラスターの場合)。
  • recovery_time (Nullable(UInt64)) — Replicated データベースのレプリカの復旧時間(Replicated データベースに属するクラスターの場合)。ミリ秒単位。

クエリ:

SELECT * FROM system.clusters LIMIT 2 FORMAT Vertical;

結果:

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


**関連項目**

- [Distributedテーブルエンジン](../../engines/table-engines/special/distributed.md)
- [distributed_replica_error_cap設定](../../operations/settings/settings.md#distributed_replica_error_cap)
- [distributed_replica_error_half_life設定](../../operations/settings/settings.md#distributed_replica_error_half_life)