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

system.replicas

ローカルサーバー上に存在するレプリケートテーブルの情報とステータスを含みます。 このテーブルは監視用途に使用できます。テーブルには、すべての Replicated* テーブルごとに 1 行が格納されます。

例:

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}

カラム:

  • database (String) - データベース名
  • table (String) - テーブル名
  • engine (String) - テーブルエンジン名
  • is_leader (UInt8) - レプリカがリーダーかどうか。 複数のレプリカが同時にリーダーになることがあります。merge_tree 設定の replicated_can_become_leader を使用して、レプリカがリーダーになることを防止できます。リーダーはバックグラウンドマージのスケジューリングを担当します。 リーダーかどうかに関わらず、利用可能で ZK にセッションを持つ任意のレプリカに対して書き込みを実行できることに注意してください。
  • can_become_leader (UInt8) - レプリカがリーダーになれるかどうか。
  • is_readonly (UInt8) - レプリカが読み取り専用モードかどうか。 このモードは、設定に ClickHouse Keeper のセクションが存在しない場合、ClickHouse Keeper でセッションを再初期化する際に不明なエラーが発生した場合、または ClickHouse Keeper でセッションを再初期化している間に有効になります。
  • is_session_expired (UInt8) - ClickHouse Keeper とのセッションが期限切れになっているかどうか。基本的には is_readonly と同じです。
  • future_parts (UInt32) - INSERT または、まだ実行されていないマージの結果として出現するデータパーツの数。
  • parts_to_check (UInt32) - 検証キュー内のデータパーツの数。パーツが破損している疑いがある場合、そのパーツは検証キューに入れられます。
  • 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) - 実行待ちのマージ数。マージには時間がかかることがあるため、この値が長時間ゼロより大きい場合があります。
  • 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 を参照してください

次の 4 列は、ZK にアクティブなセッションがある場合にのみゼロ以外の値になります。

  • log_max_index (UInt64) - 全体的なアクティビティログにおける最大エントリ番号。
  • log_pointer (UInt64) - レプリカがその実行キューへコピーした全体的なアクティビティログ中の最大エントリ番号に 1 を加えた値。log_pointer が log_max_index よりかなり小さい場合は、何か問題があります。
  • last_queue_update (DateTime) - キューが最後に更新された時刻。
  • absolute_delay (UInt64) - 現在のレプリカの遅延時間（秒単位）。
  • total_replicas (UInt8) - このテーブルの既知のレプリカの総数。
  • active_replicas (UInt8) - このテーブルのうち、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)) — レプリカ名と、そのレプリカがアクティブかどうかの対応を表すマップ。

すべてのカラムを取得すると、各行ごとに複数回 ClickHouse Keeper から読み取る必要があるため、テーブルの動作がやや遅くなる場合があります。 最後の 4 つのカラム（log_max_index、log_pointer、total_replicas、active_replicas）を取得しなければ、テーブルは高速に動作します。

例えば、次のようにしてすべてが正しく動作していることを確認できます。

SELECT
    database,
    table,
    is_leader,
    is_readonly,
    is_session_expired,
    future_parts,
    parts_to_check,
    columns_version,
    queue_size,
    inserts_in_queue,
    merges_in_queue,
    log_max_index,
    log_pointer,
    total_replicas,
    active_replicas
FROM system.replicas
WHERE
       is_readonly
    OR is_session_expired
    OR future_parts > 20
    OR parts_to_check > 10
    OR queue_size > 20
    OR inserts_in_queue > 10
    OR log_max_index - log_pointer > 10
    OR total_replicas < 2
    OR active_replicas < total_replicas

このクエリで何も返されない場合は、問題ないことを意味します。