Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

system.replicas

View as MarkdownEdit this pageReport an issueSet up docs MCP

説明

ローカルサーバー上にあるレプリケートテーブルの情報と状態を保持しています。 このテーブルは監視に利用できます。Replicated* テーブルごとに1行が含まれます。

カラム

  • 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)) — レプリカが読み取り専用モードに移行したタイムスタンプ。レプリカが読み取り専用モードでない場合は 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 エントリから得られた、他のレプリカからフェッチするパーツの名前。
  • 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とのアクティブなセッションがある場合にのみゼロ以外の値を持ちます。
  • 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)) — レプリカ名と、そのレプリカがアクティブかどうかの対応を表すMap。

別名:

  • readonly_duration — if(isNull(readonly_start_time), NULL, now() - readonly_start_time) の別名。

例

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}
Navigation