Перейти к основному содержимому
Перейти к основному содержимому

system.mutations

Таблица содержит информацию о мутациях таблиц 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_to_do_names (Array(String)) — Массив имен частей данных, которые необходимо изменить для завершения мутации.

  • parts_to_do (Int64) — Количество частей данных, которые необходимо изменить для завершения мутации.

  • 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.*:

SELECT * FROM clusterAllReplicas('cluster_name', 'db', system.mutations)
WHERE is_done=0 AND table='tmp';
подсказка

замените tmp в table='tmp' на имя таблицы, для которой вы проверяете мутации.

См. также