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

system.mutations

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

Columns:​

  • 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) — Сообщение об исключении, которое вызвало последний сбой мутации части.

Monitoring Mutations​

Чтобы отслеживать прогресс в таблице system.mutations, используйте запрос, подобный следующему - для этого требуются права на чтение таблиц system.*:

подсказка

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

См. также