> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Системная таблица, содержащая информацию о реплицируемых таблицах, находящихся на локальном сервере, и их состоянии. Полезна для мониторинга.

# system.replicas

<div id="description">
  ## Описание
</div>

Содержит информацию и статус реплицируемых таблиц, расположенных на локальном сервере.
Эту таблицу можно использовать для мониторинга. Таблица содержит по одной строке для каждой таблицы Replicated\*.

<div id="columns">
  ## Столбцы
</div>

* `database` ([String](/ru/reference/data-types/index)) — Имя базы данных.
* `table` ([String](/ru/reference/data-types/index)) — Имя таблицы.
* `uuid` ([UUID](/ru/reference/data-types/index)) — UUID таблицы.
* `engine` ([String](/ru/reference/data-types/index)) — Имя движка таблицы.
* `is_leader` ([UInt8](/ru/reference/data-types/index)) — Является ли реплика лидером. Несколько реплик могут одновременно быть лидерами. Реплике можно запретить становиться лидером с помощью настройки merge\_tree replicated\_can\_become\_leader. Лидеры отвечают за планирование фоновых слияний. Обратите внимание, что запись можно выполнять в любую доступную реплику, у которой есть сеанс в ZK, независимо от того, является ли она лидером.
* `can_become_leader` ([UInt8](/ru/reference/data-types/index)) — Может ли реплика быть лидером.
* `is_readonly` ([UInt8](/ru/reference/data-types/index)) — Находится ли реплика в режиме только для чтения. Этот режим включается, если в конфигурации нет секций с ClickHouse Keeper, если при повторной инициализации сеансов в ClickHouse Keeper произошла неизвестная ошибка, а также во время повторной инициализации сеанса в ClickHouse Keeper.
* `readonly_start_time` ([Nullable(DateTime)](/ru/reference/data-types/index)) — Временная метка перехода реплики в режим только для чтения. NULL, если реплика не находится в режиме только для чтения.
* `is_session_expired` ([UInt8](/ru/reference/data-types/index)) — Истёк ли сеанс с ClickHouse Keeper. По сути, это то же самое, что и `is_readonly`.
* `future_parts` ([UInt32](/ru/reference/data-types/index)) — Количество частей данных, которые появятся в результате операций INSERT или слияний, которые ещё не были выполнены.
* `parts_to_check` ([UInt32](/ru/reference/data-types/index)) — Количество частей данных в очереди на проверку. Часть помещается в эту очередь, если есть подозрение, что она может быть повреждена.
* `zookeeper_name` ([String](/ru/reference/data-types/index)) — Имя кластера \[Zoo]Keeper (возможно, вспомогательного), в котором хранятся метаданные таблицы
* `zookeeper_path` ([String](/ru/reference/data-types/index)) — Путь к данным таблицы в ClickHouse Keeper.
* `replica_name` ([String](/ru/reference/data-types/index)) — Имя реплики в ClickHouse Keeper. У разных реплик одной и той же таблицы разные имена.
* `replica_path` ([String](/ru/reference/data-types/index)) — Путь к данным реплики в ClickHouse Keeper. То же самое, что и конкатенация 'zookeeper\_path/replicas/replica\_path'.
* `columns_version` ([Int32](/ru/reference/data-types/index)) — Номер версии структуры таблицы. Показывает, сколько раз выполнялся ALTER. Если у реплик разные версии, это означает, что некоторые из них ещё не выполнили все ALTER.
* `queue_size` ([UInt32](/ru/reference/data-types/index)) — Размер очереди операций, ожидающих выполнения. Эти операции включают вставку блоков данных, слияния и некоторые другие действия. Обычно совпадает с future\_parts.
* `inserts_in_queue` ([UInt32](/ru/reference/data-types/index)) — Количество вставок блоков данных, которые нужно выполнить. Обычно вставки реплицируются довольно быстро. Если это число велико, значит, что-то не так.
* `merges_in_queue` ([UInt32](/ru/reference/data-types/index)) — Количество слияний, ожидающих выполнения. Иногда слияния занимают много времени, поэтому это значение может долго оставаться больше нуля.
* `part_mutations_in_queue` ([UInt32](/ru/reference/data-types/index)) — Количество мутаций, ожидающих выполнения.
* `queue_oldest_time` ([DateTime](/ru/reference/data-types/index)) — Если `queue_size` больше 0, показывает, когда в очередь была добавлена самая старая операция.
* `inserts_oldest_time` ([DateTime](/ru/reference/data-types/index)) — См. `queue_oldest_time`.
* `merges_oldest_time` ([DateTime](/ru/reference/data-types/index)) — См. `queue_oldest_time`.
* `part_mutations_oldest_time` ([DateTime](/ru/reference/data-types/index)) — См. `queue_oldest_time`.
* `oldest_part_to_get` ([String](/ru/reference/data-types/index)) — Имя части, которую нужно получить с других реплик; берётся из самой старой записи GET\_PARTS в очереди репликации.
* `oldest_part_to_merge_to` ([String](/ru/reference/data-types/index)) — Имя результирующей части, в которую выполняется слияние, полученное из самой старой записи MERGE\_PARTS в очереди репликации.
* `oldest_part_to_mutate_to` ([String](/ru/reference/data-types/index)) — Имя результирующей части, к которой применяется мутация, полученное из самой старой записи MUTATE\_PARTS в очереди репликации.
* `log_max_index` ([UInt64](/ru/reference/data-types/index)) — Максимальный номер записи в журнале общей активности. Этот столбец и следующие три (`log_pointer`, `total_replicas`, `active_replicas`) имеют ненулевое значение только при наличии активного сеанса с ClickHouse Keeper.
* `log_pointer` ([UInt64](/ru/reference/data-types/index)) — Максимальный номер записи в журнале общей активности, которую реплика скопировала в свою очередь выполнения, плюс единица. Если log\_pointer значительно меньше log\_max\_index, значит, что-то не так.
* `last_queue_update` ([DateTime](/ru/reference/data-types/index)) — Время последнего обновления очереди.
* `absolute_delay` ([UInt64](/ru/reference/data-types/index)) — Величина задержки текущей реплики в секундах.
* `total_replicas` ([UInt32](/ru/reference/data-types/index)) — Общее число известных реплик этой таблицы.
* `active_replicas` ([UInt32](/ru/reference/data-types/index)) — Число реплик этой таблицы, у которых есть сеанс в ClickHouse Keeper (то есть число работающих реплик).
* `lost_part_count` ([UInt64](/ru/reference/data-types/index)) — Общее количество утраченных частей данных в таблице по всем репликам с момента создания таблицы. Значение сохраняется в ClickHouse Keeper и может только увеличиваться.
* `last_queue_update_exception` ([String](/ru/reference/data-types/index)) — Используется, когда очередь содержит поврежденные записи. Особенно важно в случаях, когда ClickHouse нарушает обратную совместимость между версиями и записи журнала, созданные более новыми версиями, не могут быть разобраны старыми версиями.
* `zookeeper_exception` ([String](/ru/reference/data-types/index)) — Сообщение о последнем исключении, полученное, если ошибка произошла при получении информации из ClickHouse Keeper.
* `replica_is_active` ([Map(String, UInt8)](/ru/reference/data-types/index)) — Map между именем реплики и признаком того, активна ли реплика.

<div id="example">
  ## Пример
</div>

```sql theme={null}
SELECT *
FROM system.replicas
WHERE table = 'test_table'
FORMAT Vertical
```

```text theme={null}
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}
```
