> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
> Системная таблица с информацией о частях MergeTree
# system.parts
## Описание
Содержит информацию о частях таблиц [MergeTree](/docs/ru/reference/engines/table-engines/mergetree-family/mergetree).
Каждая строка описывает одну часть данных.
## Столбцы
* `partition` ([String](/docs/ru/reference/data-types/string)) — Идентификатор партиции (строковое представление, полученное из выражения ключа партиционирования).
* `name` ([String](/docs/ru/reference/data-types/string)) — Имя части данных. По структуре имени части можно определить многие аспекты данных, приёма и слияния. Формат имени части:
```text theme={null}
____
```
* Определения:
* `partition_id` — определяет ключ партиционирования
* `minimum_block_number` — определяет минимальный номер блока в части. ClickHouse всегда объединяет последовательные блоки
* `maximum_block_number` — определяет максимальный номер блока в части
* `level` — увеличивается на единицу при каждом дополнительном слиянии части. Уровень 0 означает, что это новая часть, ещё не участвовавшая в слиянии. Важно помнить, что все части в ClickHouse неизменяемы
* `data_version` — необязательное значение, увеличиваемое при мутации части (изменённые данные всегда записываются только в новую часть, поскольку части неизменяемы)
* `uuid` ([UUID](/docs/ru/reference/data-types/uuid)) — UUID части данных.
* `part_type` ([String](/docs/ru/reference/data-types/string)) — Формат хранения части данных. Возможные значения: `Wide` — каждый столбец хранится в отдельном файле, `Compact` — все столбцы хранятся в одном файле. Формат хранения данных определяется настройками `min_bytes_for_wide_part` и `min_rows_for_wide_part` таблицы семейства MergeTree.
* `part_storage_type` ([String](/docs/ru/reference/data-types/string)) — Тип `DataPartStorage`. Возможные значения: `Packed` — большинство файлов части хранится в одном архиве (проекции и несколько служебных файлов, например `txn_version.txt`, записываются отдельно), `Full` — каждый файл хранится отдельно.
* `active` ([UInt8](/docs/ru/reference/data-types/int-uint)) — Флаг, указывающий, активна ли часть данных. Активная часть данных используется в таблице; неактивная будет удалена. Неактивные части данных появляются после операций слияния и мутаций.
* `marks` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Количество меток. Чтобы получить приблизительное количество строк в части данных, умножьте количество меток на гранулярность индекса (обычно 8192). Это правило не работает при адаптивной гранулярности.
* `rows` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Количество строк.
* `files` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Количество файлов в части данных.
* `bytes_on_disk` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Общий размер всех файлов части данных в байтах.
* `data_compressed_bytes` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Общий размер сжатых данных в части данных. Вспомогательные файлы, например файлы с метками, не учитываются.
* `data_uncompressed_bytes` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Общий размер несжатых данных в части данных. Вспомогательные файлы, например файлы с метками, не учитываются.
* `primary_key_size` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Объём памяти (в байтах), занимаемый значениями первичного ключа в файле primary.idx/cidx на диске.
* `marks_bytes` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Размер файла с метками.
* `secondary_indices_compressed_bytes` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Общий размер сжатых данных вторичных индексов в части данных. Вспомогательные файлы, например файлы с метками, не учитываются.
* `secondary_indices_uncompressed_bytes` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Общий размер несжатых данных вторичных индексов в части данных. Вспомогательные файлы, например файлы с метками, не учитываются.
* `secondary_indices_marks_bytes` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Размер файла с метками для вторичных индексов.
* `modification_time` ([DateTime](/docs/ru/reference/data-types/datetime)) — Время изменения каталога с частью данных. Обычно соответствует времени создания части данных.
* `remove_time` ([DateTime](/docs/ru/reference/data-types/datetime)) — Время, когда часть данных стала неактивной.
* `refcount` ([UInt32](/docs/ru/reference/data-types/int-uint)) — Количество мест, где используется часть данных. Значение больше 2 указывает на то, что часть данных используется в запросах или слияниях.
* `min_date` ([Date](/docs/ru/reference/data-types/date)) — Минимальное значение ключа даты в части данных.
* `max_date` ([Date](/docs/ru/reference/data-types/date)) — Максимальное значение ключа даты в части данных.
* `min_time` ([DateTime](/docs/ru/reference/data-types/datetime)) — Минимальное значение ключа даты и времени в части данных.
* `max_time` ([DateTime](/docs/ru/reference/data-types/datetime)) — Максимальное значение ключа даты и времени в части данных.
* `partition_id` ([String](/docs/ru/reference/data-types/string)) — ID партиции.
* `min_block_number` ([Int64](/docs/ru/reference/data-types/int-uint)) — Минимальный номер частей данных, из которых состоит текущая часть после слияния.
* `max_block_number` ([Int64](/docs/ru/reference/data-types/int-uint)) — Максимальный номер частей данных, из которых состоит текущая часть после слияния.
* `level` ([UInt32](/docs/ru/reference/data-types/int-uint)) — Глубина дерева слияний. Ноль означает, что текущая часть создана вставкой, а не слиянием других частей.
* `data_version` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Число, используемое для определения мутаций, которые следует применить к части данных (мутации с версией выше data\_version).
* `primary_key_bytes_in_memory` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Объем памяти (в байтах), используемый значениями первичного ключа. Равен 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](/docs/ru/reference/data-types/int-uint)) — Объем памяти (в байтах), зарезервированный для значений первичного ключа. Равен 0, если включен `primary_key_lazy_load` и ключ не загружен. При ненулевом значении учитывается в `jemalloc.mergetree_arena.active_bytes`. О связи с `PrimaryIndexCacheBytes` см. примечание к `primary_key_bytes_in_memory`.
* `index_granularity_bytes_in_memory` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Объем памяти (в байтах), используемый значениями гранулярности индекса (равен 0 при primary\_key\_lazy\_load=1 и use\_primary\_key\_cache=1). При ненулевом значении байты принадлежат части и учитываются в `jemalloc.mergetree_arena.active_bytes`.
* `index_granularity_bytes_in_memory_allocated` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Объем памяти (в байтах), зарезервированный для значений гранулярности индекса (равен 0 при primary\_key\_lazy\_load=1 и use\_primary\_key\_cache=1). При ненулевом значении учитывается в `jemalloc.mergetree_arena.active_bytes`.
* `is_frozen` ([UInt8](/docs/ru/reference/data-types/int-uint)) — Флаг, указывающий на наличие резервной копии данных партиции. 1 — резервная копия существует. 0 — резервная копия отсутствует. Подробнее см. FREEZE PARTITION.
* `database` ([String](/docs/ru/reference/data-types/string)) — Имя базы данных.
* `table` ([String](/docs/ru/reference/data-types/string)) — Имя таблицы.
* `engine` ([String](/docs/ru/reference/data-types/string)) — Имя движка таблицы без параметров.
* `disk_name` ([String](/docs/ru/reference/data-types/string)) — Имя диска, на котором хранится часть данных.
* `path` ([String](/docs/ru/reference/data-types/string)) — Абсолютный путь к папке с файлами части данных.
* `hash_of_all_files` ([String](/docs/ru/reference/data-types/string)) — sipHash128 сжатых файлов.
* `hash_of_uncompressed_files` ([String](/docs/ru/reference/data-types/string)) — sipHash128 несжатых файлов (файлов с метками, файла индекса и т. д.).
* `uncompressed_hash_of_compressed_files` ([String](/docs/ru/reference/data-types/string)) — sipHash128 данных в сжатых файлах, как если бы они были несжатыми.
* `delete_ttl_info_min` ([DateTime](/docs/ru/reference/data-types/datetime)) — Минимальное значение ключа даты и времени для правила TTL DELETE.
* `delete_ttl_info_max` ([DateTime](/docs/ru/reference/data-types/datetime)) — Максимальное значение ключа даты и времени для правила TTL DELETE.
* `move_ttl_info.expression` ([Array(String)](/docs/ru/reference/data-types/array)) — Массив выражений. Каждое выражение определяет правило TTL MOVE.
* `move_ttl_info.min` ([Array(DateTime)](/docs/ru/reference/data-types/array)) — Массив значений даты и времени. Каждый элемент задает минимальное значение ключа для правила TTL MOVE.
* `move_ttl_info.max` ([Array(DateTime)](/docs/ru/reference/data-types/array)) — Массив значений даты и времени. Каждый элемент задает максимальное значение ключа для правила TTL MOVE.
* `default_compression_codec` ([String](/docs/ru/reference/data-types/string)) — Имя кодека, используемого для сжатия этой части данных, если для столбца не задан явный кодек или используется `CODEC(Default)`. При использовании `allow_experimental_adaptive_codec_selection` отдельные блоки таких столбцов могут использовать другие кодеки; см. [`mergeTreeCodecBlockCounts`](/docs/ru/reference/functions/table-functions/mergeTreeCodecBlockCounts).
* `recompression_ttl_info.expression` ([Array(String)](/docs/ru/reference/data-types/array)) — TTL-выражение.
* `recompression_ttl_info.min` ([Array(DateTime)](/docs/ru/reference/data-types/array)) — Минимальное значение вычисленного TTL-выражения в этой части. Используется, чтобы определить, есть ли хотя бы одна строка с истёкшим TTL.
* `recompression_ttl_info.max` ([Array(DateTime)](/docs/ru/reference/data-types/array)) — Максимальное значение вычисленного TTL-выражения в этой части. Используется, чтобы определить, у всех ли строк истёк TTL.
* `group_by_ttl_info.expression` ([Array(String)](/docs/ru/reference/data-types/array)) — TTL-выражение.
* `group_by_ttl_info.min` ([Array(DateTime)](/docs/ru/reference/data-types/array)) — Минимальное значение вычисленного TTL-выражения в этой части. Используется, чтобы определить, есть ли хотя бы одна строка с истёкшим TTL.
* `group_by_ttl_info.max` ([Array(DateTime)](/docs/ru/reference/data-types/array)) — Максимальное значение вычисленного TTL-выражения в этой части. Используется, чтобы определить, у всех ли строк истёк TTL.
* `rows_where_ttl_info.expression` ([Array(String)](/docs/ru/reference/data-types/array)) — TTL-выражение.
* `rows_where_ttl_info.min` ([Array(DateTime)](/docs/ru/reference/data-types/array)) — Минимальное значение вычисленного TTL-выражения в этой части. Используется, чтобы определить, есть ли хотя бы одна строка с истёкшим TTL.
* `rows_where_ttl_info.max` ([Array(DateTime)](/docs/ru/reference/data-types/array)) — Максимальное значение вычисленного TTL-выражения в этой части. Используется, чтобы определить, у всех ли строк истёк TTL.
* `projections` ([Array(String)](/docs/ru/reference/data-types/array)) — Список имён проекций, вычисленных для этой части.
* `visible` ([UInt8](/docs/ru/reference/data-types/int-uint)) — Флаг, указывающий, доступна ли эта часть для SELECT-запросов.
* `creation_tid` ([Tuple(UInt64, UInt64, UUID)](/docs/ru/reference/data-types/tuple)) — ID транзакции, создавшей или пытающейся создать этот объект.
* `removal_tid_lock` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Хеш removal\_tid, используемый для блокировки объекта на время удаления.
* `removal_tid` ([Tuple(UInt64, UInt64, UUID)](/docs/ru/reference/data-types/tuple)) — ID транзакции, удалившей или пытающейся удалить этот объект
* `creation_csn` ([UInt64](/docs/ru/reference/data-types/int-uint)) — CSN транзакции, создавшей этот объект
* `removal_csn` ([UInt64](/docs/ru/reference/data-types/int-uint)) — CSN транзакции, удалившей этот объект
* `has_lightweight_delete` ([UInt8](/docs/ru/reference/data-types/int-uint)) — Флаг, указывающий, есть ли у части маска легковесного удаления.
* `last_removal_attempt_time` ([DateTime](/docs/ru/reference/data-types/datetime)) — Время последней попытки сервера удалить эту часть.
* `removal_state` ([String](/docs/ru/reference/data-types/string)) — Текущее состояние процесса удаления части.
**Псевдонимы:**
* `bytes` — псевдоним `bytes_on_disk`.
* `marks_size` — псевдоним `marks_bytes`.
* `part_name` — псевдоним `name`.
## Пример
```sql theme={null}
SELECT * FROM system.parts LIMIT 1 FORMAT Vertical;
```
```text theme={null}
Row 1:
──────
partition: tuple()
name: all_1_4_1_6
part_type: Wide
part_storage_type: Full
active: 1
marks: 2
rows: 6
bytes_on_disk: 310
data_compressed_bytes: 157
data_uncompressed_bytes: 91
secondary_indices_compressed_bytes: 58
secondary_indices_uncompressed_bytes: 6
secondary_indices_marks_bytes: 48
marks_bytes: 144
modification_time: 2020-06-18 13:01:49
remove_time: 1970-01-01 00:00:00
refcount: 1
min_date: 1970-01-01
max_date: 1970-01-01
min_time: 1970-01-01 00:00:00
max_time: 1970-01-01 00:00:00
partition_id: all
min_block_number: 1
max_block_number: 4
level: 1
data_version: 6
primary_key_bytes_in_memory: 8
primary_key_bytes_in_memory_allocated: 64
is_frozen: 0
database: default
table: months
engine: MergeTree
disk_name: default
path: /var/lib/clickhouse/data/default/months/all_1_4_1_6/
hash_of_all_files: 2d0657a16d9430824d35e327fcbd87bf
hash_of_uncompressed_files: 84950cc30ba867c77a408ae21332ba29
uncompressed_hash_of_compressed_files: 1ad78f1c6843bbfb99a2c931abe7df7d
delete_ttl_info_min: 1970-01-01 00:00:00
delete_ttl_info_max: 1970-01-01 00:00:00
move_ttl_info.expression: []
move_ttl_info.min: []
move_ttl_info.max: []
```
## См. также
* [Семейство движков MergeTree](/docs/ru/reference/engines/table-engines/mergetree-family/mergetree)
* [TTL для столбцов и таблиц](/docs/ru/reference/engines/table-engines/mergetree-family/mergetree#table_engine-mergetree-ttl)