Skip to main content

​
Описание

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

​
Столбцы

  • partition (String) — Идентификатор партиции (строковое представление, полученное из выражения ключа партиционирования).
  • name (String) — Имя части данных. По структуре имени части можно определить многие аспекты данных, приёма и слияния. Формат имени части:
    • Определения:
      • partition_id — определяет ключ партиционирования
      • minimum_block_number — определяет минимальный номер блока в части. ClickHouse всегда объединяет последовательные блоки
      • maximum_block_number — определяет максимальный номер блока в части
      • level — увеличивается на единицу при каждом дополнительном слиянии части. Уровень 0 означает, что это новая часть, ещё не участвовавшая в слиянии. Важно помнить, что все части в ClickHouse неизменяемы
      • data_version — необязательное значение, увеличиваемое при мутации части (изменённые данные всегда записываются только в новую часть, поскольку части неизменяемы)
  • uuid (UUID) — UUID части данных.
  • part_type (String) — Формат хранения части данных. Возможные значения: Wide — каждый столбец хранится в отдельном файле, Compact — все столбцы хранятся в одном файле. Формат хранения данных определяется настройками min_bytes_for_wide_part и min_rows_for_wide_part таблицы семейства MergeTree.
  • part_storage_type (String) — Тип DataPartStorage. Возможные значения: Packed — большинство файлов части хранится в одном архиве (проекции и несколько служебных файлов, например txn_version.txt, записываются отдельно), Full — каждый файл хранится отдельно.
  • active (UInt8) — Флаг, указывающий, активна ли часть данных. Активная часть данных используется в таблице; неактивная будет удалена. Неактивные части данных появляются после операций слияния и мутаций.
  • marks (UInt64) — Количество меток. Чтобы получить приблизительное количество строк в части данных, умножьте количество меток на гранулярность индекса (обычно 8192). Это правило не работает при адаптивной гранулярности.
  • rows (UInt64) — Количество строк.
  • files (UInt64) — Количество файлов в части данных.
  • bytes_on_disk (UInt64) — Общий размер всех файлов части данных в байтах.
  • data_compressed_bytes (UInt64) — Общий размер сжатых данных в части данных. Вспомогательные файлы, например файлы с метками, не учитываются.
  • data_uncompressed_bytes (UInt64) — Общий размер несжатых данных в части данных. Вспомогательные файлы, например файлы с метками, не учитываются.
  • primary_key_size (UInt64) — Объём памяти (в байтах), занимаемый значениями первичного ключа в файле primary.idx/cidx на диске.
  • marks_bytes (UInt64) — Размер файла с метками.
  • secondary_indices_compressed_bytes (UInt64) — Общий размер сжатых данных вторичных индексов в части данных. Вспомогательные файлы, например файлы с метками, не учитываются.
  • secondary_indices_uncompressed_bytes (UInt64) — Общий размер несжатых данных вторичных индексов в части данных. Вспомогательные файлы, например файлы с метками, не учитываются.
  • secondary_indices_marks_bytes (UInt64) — Размер файла с метками для вторичных индексов.
  • modification_time (DateTime) — Время изменения каталога с частью данных. Обычно соответствует времени создания части данных.
  • remove_time (DateTime) — Время, когда часть данных стала неактивной.
  • refcount (UInt32) — Количество мест, где используется часть данных. Значение больше 2 указывает на то, что часть данных используется в запросах или слияниях.
  • min_date (Date) — Минимальное значение ключа даты в части данных.
  • max_date (Date) — Максимальное значение ключа даты в части данных.
  • min_time (DateTime) — Минимальное значение ключа даты и времени в части данных.
  • max_time (DateTime) — Максимальное значение ключа даты и времени в части данных.
  • partition_id (String) — ID партиции.
  • min_block_number (Int64) — Минимальный номер частей данных, из которых состоит текущая часть после слияния.
  • max_block_number (Int64) — Максимальный номер частей данных, из которых состоит текущая часть после слияния.
  • level (UInt32) — Глубина дерева слияний. Ноль означает, что текущая часть создана вставкой, а не слиянием других частей.
  • data_version (UInt64) — Число, используемое для определения мутаций, которые следует применить к части данных (мутации с версией выше data_version).
  • primary_key_bytes_in_memory (UInt64) — Объем памяти (в байтах), используемый значениями первичного ключа. Равен 0, если включен primary_key_lazy_load и ключ не загружен. При ненулевом значении байты находятся в самой части и учитываются в jemalloc.mergetree_arena.active_bytes. Они НИКОГДА не учитываются в PrimaryIndexCacheBytes: для каждой части это взаимоисключающие варианты — индекс находится либо в части (эта метрика), либо в общем PrimaryIndexCache (другая метрика), в зависимости от primary_key_lazy_load и use_primary_key_cache.
  • primary_key_bytes_in_memory_allocated (UInt64) — Объем памяти (в байтах), зарезервированный для значений первичного ключа. Равен 0, если включен primary_key_lazy_load и ключ не загружен. При ненулевом значении учитывается в jemalloc.mergetree_arena.active_bytes. О связи с PrimaryIndexCacheBytes см. примечание к primary_key_bytes_in_memory.
  • index_granularity_bytes_in_memory (UInt64) — Объем памяти (в байтах), используемый значениями гранулярности индекса (равен 0 при primary_key_lazy_load=1 и use_primary_key_cache=1). При ненулевом значении байты принадлежат части и учитываются в jemalloc.mergetree_arena.active_bytes.
  • index_granularity_bytes_in_memory_allocated (UInt64) — Объем памяти (в байтах), зарезервированный для значений гранулярности индекса (равен 0 при primary_key_lazy_load=1 и use_primary_key_cache=1). При ненулевом значении учитывается в jemalloc.mergetree_arena.active_bytes.
  • is_frozen (UInt8) — Флаг, указывающий на наличие резервной копии данных партиции. 1 — резервная копия существует. 0 — резервная копия отсутствует. Подробнее см. FREEZE PARTITION.
  • database (String) — Имя базы данных.
  • table (String) — Имя таблицы.
  • engine (String) — Имя движка таблицы без параметров.
  • disk_name (String) — Имя диска, на котором хранится часть данных.
  • path (String) — Абсолютный путь к папке с файлами части данных.
  • hash_of_all_files (String) — sipHash128 сжатых файлов.
  • hash_of_uncompressed_files (String) — sipHash128 несжатых файлов (файлов с метками, файла индекса и т. д.).
  • uncompressed_hash_of_compressed_files (String) — sipHash128 данных в сжатых файлах, как если бы они были несжатыми.
  • delete_ttl_info_min (DateTime) — Минимальное значение ключа даты и времени для правила TTL DELETE.
  • delete_ttl_info_max (DateTime) — Максимальное значение ключа даты и времени для правила TTL DELETE.
  • move_ttl_info.expression (Array(String)) — Массив выражений. Каждое выражение определяет правило TTL MOVE.
  • move_ttl_info.min (Array(DateTime)) — Массив значений даты и времени. Каждый элемент задает минимальное значение ключа для правила TTL MOVE.
  • move_ttl_info.max (Array(DateTime)) — Массив значений даты и времени. Каждый элемент задает максимальное значение ключа для правила TTL MOVE.
  • default_compression_codec (String) — Имя кодека, используемого для сжатия этой части данных, если для столбца не задан явный кодек или используется CODEC(Default). При использовании allow_experimental_adaptive_codec_selection отдельные блоки таких столбцов могут использовать другие кодеки; см. mergeTreeCodecBlockCounts.
  • recompression_ttl_info.expression (Array(String)) — TTL-выражение.
  • recompression_ttl_info.min (Array(DateTime)) — Минимальное значение вычисленного TTL-выражения в этой части. Используется, чтобы определить, есть ли хотя бы одна строка с истёкшим TTL.
  • recompression_ttl_info.max (Array(DateTime)) — Максимальное значение вычисленного TTL-выражения в этой части. Используется, чтобы определить, у всех ли строк истёк TTL.
  • group_by_ttl_info.expression (Array(String)) — TTL-выражение.
  • group_by_ttl_info.min (Array(DateTime)) — Минимальное значение вычисленного TTL-выражения в этой части. Используется, чтобы определить, есть ли хотя бы одна строка с истёкшим TTL.
  • group_by_ttl_info.max (Array(DateTime)) — Максимальное значение вычисленного TTL-выражения в этой части. Используется, чтобы определить, у всех ли строк истёк TTL.
  • rows_where_ttl_info.expression (Array(String)) — TTL-выражение.
  • rows_where_ttl_info.min (Array(DateTime)) — Минимальное значение вычисленного TTL-выражения в этой части. Используется, чтобы определить, есть ли хотя бы одна строка с истёкшим TTL.
  • rows_where_ttl_info.max (Array(DateTime)) — Максимальное значение вычисленного TTL-выражения в этой части. Используется, чтобы определить, у всех ли строк истёк TTL.
  • projections (Array(String)) — Список имён проекций, вычисленных для этой части.
  • visible (UInt8) — Флаг, указывающий, доступна ли эта часть для SELECT-запросов.
  • creation_tid (Tuple(UInt64, UInt64, UUID)) — ID транзакции, создавшей или пытающейся создать этот объект.
  • removal_tid_lock (UInt64) — Хеш removal_tid, используемый для блокировки объекта на время удаления.
  • removal_tid (Tuple(UInt64, UInt64, UUID)) — ID транзакции, удалившей или пытающейся удалить этот объект
  • creation_csn (UInt64) — CSN транзакции, создавшей этот объект
  • removal_csn (UInt64) — CSN транзакции, удалившей этот объект
  • has_lightweight_delete (UInt8) — Флаг, указывающий, есть ли у части маска легковесного удаления.
  • last_removal_attempt_time (DateTime) — Время последней попытки сервера удалить эту часть.
  • removal_state (String) — Текущее состояние процесса удаления части.
Псевдонимы:
  • bytes — псевдоним bytes_on_disk.
  • marks_size — псевдоним marks_bytes.
  • part_name — псевдоним name.

​
Пример

​
См. также

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