Содержит информацию и статус реплицируемых таблиц, расположенных на локальном сервере.
Эту таблицу можно использовать для мониторинга. Таблица содержит по одной строке для каждой таблицы Replicated*.
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) — Находится ли реплика в режиме только для чтения. Этот режим включается, если в конфигурации нет секций с 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) — Количество слияний, ожидающих выполнения. Иногда слияния занимают много времени, поэтому это значение может долго оставаться больше нуля.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) — Максимальный номер записи в журнале общей активности. Этот столбец и следующие три (log_pointer, total_replicas, active_replicas) имеют ненулевое значение только при наличии активного сеанса с ClickHouse Keeper.log_pointer (UInt64) — Максимальный номер записи в журнале общей активности, которую реплика скопировала в свою очередь выполнения, плюс единица. Если 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 между именем реплики и признаком того, активна ли реплика.
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}
Последнее изменение 25 июня 2026 г.
