Skip to main content

​
Описание

Таблица содержит информацию о Мутациях таблиц MergeTree и ходе их выполнения. Каждой команде мутации соответствует одна строка.

​
Столбцы:

  • database (String) — Имя базы данных, к которой была применена мутация.
  • table (String) — Имя таблицы, к которой была применена мутация.
  • mutation_id (String) — ID мутации. Для реплицируемых таблиц эти ID соответствуют именам znode в каталоге <table_path_in_clickhouse_keeper>/mutations/ в ClickHouse Keeper. Для нереплицируемых таблиц ID соответствуют именам файлов в каталоге данных таблицы.
  • command (String) — Строка команды мутации (часть запроса после ALTER TABLE [db.]table).
  • create_time (DateTime) — Дата и время отправки команды мутации на выполнение.
  • block_numbers.partition_id (Array(String)) — Для мутаций реплицируемых таблиц массив содержит ID партиций’ (по одной записи для каждой партиции). Для мутаций нереплицируемых таблиц массив пуст.
  • block_numbers.number (Array(Int64)) — Для мутаций реплицируемых таблиц массив содержит по одной записи для каждой партиции с номером блока, полученным мутацией. В партиции будут мутированы только части, содержащие блоки с номерами меньше этого номера. В нереплицируемых таблицах номера блоков во всех партициях образуют единую последовательность. Это означает, что для мутаций нереплицируемых таблиц столбец будет содержать одну запись с единственным номером блока, полученным мутацией.
  • parts_in_progress_names (Array(String)) — Массив имен частей данных, которые в настоящее время мутируются.
  • parts_to_do_names (Array(String)) — Массив имен частей данных, которые необходимо мутировать для завершения мутации.
  • parts_to_do (Int64) — Количество частей данных, которые необходимо мутировать для завершения мутации. Примечание: даже если parts_to_do = 0, мутация реплицируемой таблицы может еще не завершиться из-за длительно выполняющейся операции INSERT, создающей новую часть данных, которую потребуется мутировать.
  • parts_postpone_reasons (Map(String, String)) — Карта имен частей и причин, по которым их обработка отложена.
  • is_done (UInt8) — Флаг, указывающий, завершена ли мутация. Возможные значения: 1, если мутация завершена, 0, если мутация все еще выполняется.
  • is_killed (UInt8) — Указывает, была ли мутация принудительно завершена. Доступно только в ClickHouse Cloud. Примечание: is_killed=1 не обязательно означает, что обработка мутации полностью завершена. Мутация может длительное время оставаться в состоянии, при котором is_killed=1 и is_done=0. Это может произойти, если другая длительно выполняющаяся мутация блокирует принудительно завершенную мутацию. Это нормальная ситуация.
  • latest_failed_part (String) — Имя последней части, которую не удалось мутировать.
  • latest_fail_time (DateTime) — Дата и время последнего сбоя мутации части.
  • latest_fail_reason (String) — Сообщение исключения, вызвавшего последний сбой мутации части.
  • latest_fail_error_code_name (String) — Код ошибки исключения, вызвавшего последний сбой мутации части.
  • Если имя части отсутствует в parts_postpone_reasons и она ещё не была мутирована, это означает, что часть ещё не запланирована для мутации.
  • Имя части all_parts обозначает все части, которые ещё не были мутированы.
  • is_killed (UInt8) — Указывает, была ли мутация принудительно завершена. Доступно только в ClickHouse Cloud.
is_killed=1 не обязательно означает, что мутация полностью завершена. Мутация может длительное время оставаться в состоянии, при котором is_killed=1 и is_done=0. Это может произойти, если другая длительно выполняющаяся мутация блокирует принудительно завершённую мутацию. Это нормальная ситуация.
  • is_done (UInt8) — Флаг, указывающий, завершена ли мутация. Возможные значения:
    • 1, если мутация завершена,
    • 0, если мутация всё ещё выполняется.
Даже если parts_to_do = 0, мутация реплицируемой таблицы может быть ещё не завершена из-за длительно выполняющегося запроса INSERT, который создаст новую часть данных, к которой нужно будет применить мутацию.
Если при мутации некоторых частей данных возникли проблемы, следующие столбцы содержат дополнительную информацию:
  • latest_failed_part (String) — Имя последней части данных, для которой не удалось выполнить мутацию.
  • latest_fail_time (DateTime) — Дата и время последнего сбоя мутации части.
  • latest_fail_reason (String) — Сообщение об исключении, вызвавшем последний сбой мутации части.

​
Мониторинг мутаций

Чтобы отслеживать ход выполнения в таблице system.mutations, используйте следующий запрос:
Примечание: для этого требуются разрешения на чтение таблиц system.*.
Использование в CloudВ ClickHouse Cloud таблица system.mutations на каждом узле содержит все мутации кластера, поэтому clusterAllReplicas не требуется.

​
См. также

Последнее изменение 14 августа 2026 г.