mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-11-08 08:35:20 +00:00
125 lines
8.1 KiB
Markdown
125 lines
8.1 KiB
Markdown
# system.replicas {#system_tables-replicas}
|
||
|
||
Содержит информацию и статус для реплицируемых таблиц, расположенных на локальном сервере.
|
||
Эту таблицу можно использовать для мониторинга. Таблица содержит по строчке для каждой Replicated\*-таблицы.
|
||
|
||
Пример:
|
||
|
||
``` sql
|
||
SELECT *
|
||
FROM system.replicas
|
||
WHERE table = 'visits'
|
||
FORMAT Vertical
|
||
```
|
||
|
||
``` text
|
||
Row 1:
|
||
──────
|
||
database: merge
|
||
table: visits
|
||
engine: ReplicatedCollapsingMergeTree
|
||
is_leader: 1
|
||
can_become_leader: 1
|
||
is_readonly: 0
|
||
is_session_expired: 0
|
||
future_parts: 1
|
||
parts_to_check: 0
|
||
zookeeper_path: /clickhouse/tables/01-06/visits
|
||
replica_name: example01-06-1.yandex.ru
|
||
replica_path: /clickhouse/tables/01-06/visits/replicas/example01-06-1.yandex.ru
|
||
columns_version: 9
|
||
queue_size: 1
|
||
inserts_in_queue: 0
|
||
merges_in_queue: 1
|
||
part_mutations_in_queue: 0
|
||
queue_oldest_time: 2020-02-20 08:34:30
|
||
inserts_oldest_time: 0000-00-00 00:00:00
|
||
merges_oldest_time: 2020-02-20 08:34:30
|
||
part_mutations_oldest_time: 0000-00-00 00:00:00
|
||
oldest_part_to_get:
|
||
oldest_part_to_merge_to: 20200220_20284_20840_7
|
||
oldest_part_to_mutate_to:
|
||
log_max_index: 596273
|
||
log_pointer: 596274
|
||
last_queue_update: 2020-02-20 08:34:32
|
||
absolute_delay: 0
|
||
total_replicas: 2
|
||
active_replicas: 2
|
||
```
|
||
|
||
Столбцы:
|
||
|
||
- `database` (`String`) - имя БД.
|
||
- `table` (`String`) - имя таблицы.
|
||
- `engine` (`String`) - имя движка таблицы.
|
||
- `is_leader` (`UInt8`) - является ли реплика лидером.
|
||
Несколько реплик могут быть лидерами одновременно. Реплике можно запретить быть лидером с помощью `merge_tree` настройки `replicated_can_become_leader`. Лидеры назначают фоновые слияния, которые следует произвести.
|
||
Замечу, что запись можно осуществлять на любую реплику (доступную и имеющую сессию в ZK), независимо от лидерства.
|
||
- `can_become_leader` (`UInt8`) - может ли реплика быть лидером.
|
||
- `is_readonly` (`UInt8`) - находится ли реплика в режиме «только для чтения»
|
||
Этот режим включается, если в конфиге нет секции с ZK; если при переинициализации сессии в ZK произошла неизвестная ошибка; во время переинициализации сессии с ZK.
|
||
- `is_session_expired` (`UInt8`) - истекла ли сессия с ZK. В основном, то же самое, что и `is_readonly`.
|
||
- `future_parts` (`UInt32`) - количество кусков с данными, которые появятся в результате INSERT-ов или слияний, которых ещё предстоит сделать
|
||
- `parts_to_check` (`UInt32`) - количество кусков с данными в очереди на проверку. Кусок помещается в очередь на проверку, если есть подозрение, что он может быть битым.
|
||
- `zookeeper_path` (`String`) - путь к данным таблицы в ZK.
|
||
- `replica_name` (`String`) - имя реплики в ZK; разные реплики одной таблицы имеют разное имя.
|
||
- `replica_path` (`String`) - путь к данным реплики в ZK. То же самое, что конкатенация 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`) - максимальный номер записи из общего лога действий, которую реплика скопировала в свою очередь для выполнения, плюс единица. Если log_pointer сильно меньше log_max_index, значит что-то не так.
|
||
- `last_queue_update` (`DateTime`) - When the queue was updated last time.
|
||
- `absolute_delay` (`UInt64`) - How big lag in seconds the current replica has.
|
||
- `total_replicas` (`UInt8`) - общее число известных реплик этой таблицы.
|
||
- `active_replicas` (`UInt8`) - число реплик этой таблицы, имеющих сессию в ZK; то есть, число работающих реплик.
|
||
|
||
Если запрашивать все столбцы, то таблица может работать слегка медленно, так как на каждую строчку делается несколько чтений из ZK.
|
||
Если не запрашивать последние 4 столбца (log_max_index, log_pointer, total_replicas, active_replicas), то таблица работает быстро.
|
||
|
||
Например, так можно проверить, что всё хорошо:
|
||
|
||
``` sql
|
||
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
|
||
```
|
||
|
||
Если этот запрос ничего не возвращает - значит всё хорошо.
|
||
|
||
[Оригинальная статья](https://clickhouse.tech/docs/ru/operations/system_tables/replicas) <!--hide-->
|
||
|