Перейти к основному содержанию
Запросы в ClickHouse CloudДанные в этой системной таблице хранятся локально на каждом узле ClickHouse Cloud. Поэтому, чтобы получить полное представление обо всех данных, требуется функция clusterAllReplicas. Дополнительные сведения см. здесь.

Описание

Таблица system.part_log создается только в том случае, если указана настройка сервера part_log. Эта таблица содержит информацию о событиях, происходивших с частями данных в таблицах семейства MergeTree, например о добавлении данных или их слиянии. Таблица system.part_log содержит следующие столбцы:

Столбцы

  • hostname (LowCardinality(String)) — имя хоста сервера, выполняющего запрос.
  • query_id (String) — Идентификатор запроса INSERT, в результате которого была создана эта часть данных.
  • event_type (Enum8(‘NewPart’ = 1, ‘MergeParts’ = 2, ‘DownloadPart’ = 3, ‘RemovePart’ = 4, ‘MutatePart’ = 5, ‘MovePart’ = 6, ‘MergePartsStart’ = 7, ‘MutatePartStart’ = 8)) — Тип события, произошедшего с частью данных. Может принимать одно из следующих значений: NewPart — вставка новой части данных, MergePartsStart — слияние частей данных началось, MergeParts — слияние частей данных завершилось, DownloadPart — загрузка части данных, RemovePart — удаление или отсоединение части данных с помощью DETACH PARTITION. MutatePartStart — мутация части данных началась, MutatePart — мутация части данных завершилась, MovePart — перемещение части данных с одного диска на другой.
  • merge_reason (Enum8(‘NotAMerge’ = 1, ‘RegularMerge’ = 2, ‘TTLDeleteMerge’ = 3, ‘TTLRecompressMerge’ = 4, ‘TTLDropMerge’ = 5)) — Причина события типа MERGE_PARTS. Может принимать одно из следующих значений: NotAMerge — текущее событие имеет тип, отличный от MERGE_PARTS, RegularMerge — обычное слияние, TTLDeleteMerge, TTLDropMerge — очистка устаревших данных. TTLRecompressMerge — повторное сжатие части данных с помощью.
  • merge_algorithm (Enum8(‘Undecided’ = 0, ‘Vertical’ = 1, ‘Horizontal’ = 2)) — Алгоритм слияния для события типа MERGE_PARTS. Может принимать одно из следующих значений: Undecided, Horizontal, Vertical
  • event_date (Date) — дата события.
  • event_time (DateTime) — Время события.
  • event_time_microseconds (DateTime64(6)) — Время события с точностью до микросекунд.
  • duration_ms (UInt64) — Продолжительность этой операции.
  • database (String) — Имя базы данных, в которой находится эта часть данных.
  • table (String) — Имя таблицы, которой принадлежит часть данных.
  • table_uuid (UUID) — UUID таблицы, которой принадлежит часть данных.
  • part_name (String) — Название части данных.
  • partition_id (String) — идентификатор партиции, в которую была вставлена часть данных. Столбец принимает значение all, если партиционирование выполняется по tuple().
  • partition (String) — Имя партиции.
  • part_type (String) — Тип части данных. Возможные значения: Wide и Compact.
  • part_storage_type (String) — Тип DataPartStorage. Возможные значения: Packed — все файлы хранятся в одном blob, Full — отдельный blob для каждого файла.
  • disk_name (String) — Имя диска, на котором расположена часть данных.
  • path_on_disk (String) — Абсолютный путь к папке с файлами части данных.
  • rows (UInt64) — количество строк в части данных.
  • size_in_bytes (UInt64) — Размер части данных на диске, в байтах.
  • merged_from (Array(String)) — Массив имён частей-источников, из которых была сформирована текущая часть.
  • bytes_uncompressed (UInt64) — Размер результирующей части без сжатия в байтах.
  • read_rows (UInt64) — Количество строк, прочитанных в ходе слияния.
  • read_bytes (UInt64) — Количество байтов, считанных при слиянии.
  • peak_memory_usage (UInt64) — Максимальный объём оперативной памяти, использованный во время слияния
  • deduplication_block_ids (Array(String)) — Массив идентификаторов блоков, используемый для дедупликации при вставке данной части.
  • error (UInt16) — Код ошибки, соответствующей возникшему исключению.
  • exception (String) — Текст сообщения об ошибке.
  • mutation_ids (Array(String)) — массив идентификаторов мутаций, применённых к исходной части (merged_from), для события типа MUTATE_PART_START и MUTATE_PART.
  • ProfileEvents (Map(LowCardinality(String), UInt64)) — Все события профилирования, собранные во время этой операции.
  • projections_duration_ms (Map(LowCardinality(String), UInt64)) — Длительность слияния/перестроения каждой проекции в миллисекундах.
Псевдонимы:
  • ProfileEvents.Names — псевдоним mapKeys(ProfileEvents).
  • ProfileEvents.Values — псевдоним mapValues(ProfileEvents).
  • name — псевдоним part_name.
Таблица system.part_log создается после первой вставки данных в таблицу MergeTree.

Пример

Последнее изменение 1 июля 2026 г.