system.parts_columns

Системная таблица, содержащая сведения о частях и столбцах таблиц MergeTree.

​

Описание

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

​

Столбцы

• partition (String) — имя партиции.
• name (String) — Имя части данных.
• uuid (UUID) — UUID части.
• part_type (String) — Формат хранения части данных. Возможные значения: Wide — каждый столбец хранится в отдельном файле в файловой системе, Compact — все столбцы хранятся в одном файле в файловой системе.
• active (UInt8) — флаг, указывающий, активна ли часть данных. Если часть данных активна, она используется в таблице. В противном случае она удаляется. Неактивные части данных остаются после слияния.
• marks (UInt64) — Количество меток. Чтобы получить приблизительное количество строк в части данных, умножьте число меток на гранулярность индекса (обычно 8192) (эта подсказка не работает для адаптивной гранулярности).
• rows (UInt64) — Количество строк.
• bytes_on_disk (UInt64) — Суммарный размер в байтах всех файлов частей данных.
• data_compressed_bytes (UInt64) — Общий размер сжатых данных в части данных. Вспомогательные файлы (например, файлы с метками) не учитываются.
• data_uncompressed_bytes (UInt64) — Общий размер несжатых данных в части данных. Все вспомогательные файлы (например, файлы с метками) не учитываются.
• marks_bytes (UInt64) — Размер файла меток.
• modification_time (DateTime) — Время, когда был изменён каталог с частью данных. Обычно оно соответствует времени создания части данных.
• remove_time (DateTime) — Время, когда часть данных стала неактивной.
• refcount (UInt32) — Количество мест, в которых используется часть данных. Значение больше 2 указывает на то, что часть данных используется в запросах или при слияниях.
• min_date (Date) — минимальное значение для столбца Date, если он входит в ключ партиционирования.
• max_date (Date) — Максимальное значение в столбце Date, если он входит в ключ партиционирования.
• min_time (DateTime) — минимальное значение для столбца DateTime, если он входит в ключ партиционирования.
• max_time (DateTime) — Максимальное значение столбца DateTime, если он включён в ключ партиционирования.
• partition_id (String) — идентификатор партиции.
• min_block_number (Int64) — Минимальный номер среди частей данных, образующих текущую часть после слияния.
• max_block_number (Int64) — Максимальное число частей данных, образующих текущую часть после слияния.
• level (UInt32) — Глубина дерева слияния. Ноль означает, что текущая часть была создана в результате вставки, а не слияния других частей.
• data_version (UInt64) — число, используемое для определения того, какие мутации должны быть применены к части данных (мутации с версией выше data_version).
• primary_key_bytes_in_memory (UInt64) — Объём памяти (в байтах), используемый для хранения значений первичного ключа.
• primary_key_bytes_in_memory_allocated (UInt64) — Объём памяти (в байтах), зарезервированный для значений первичного ключа.
• database (String) — Название базы данных.
• table (String) — Название таблицы.
• engine (String) — Название движка таблицы без параметров.
• disk_name (String) — Имя диска, хранящего часть данных.
• path (String) — Абсолютный путь к каталогу с файлами части данных.
• column (String) — Название столбца.
• type (String) — Тип столбца.
• column_position (UInt64) — Порядковый номер столбца в таблице, начиная с 1.
• default_kind (String) — тип выражения (DEFAULT, MATERIALIZED, ALIAS) для значения по умолчанию либо пустая строка, если оно не задано.
• default_expression (String) — Выражение для значения по умолчанию или пустая строка, если оно не задано.
• column_bytes_on_disk (UInt64) — Общий размер столбца в байтах.
• column_data_compressed_bytes (UInt64) — Общий размер сжатых данных в столбце, в байтах.
• column_data_uncompressed_bytes (UInt64) — Общий размер несжатых данных в столбце в байтах.
• column_marks_bytes (UInt64) — Размер меток столбца, в байтах.
• column_modification_time (Nullable(DateTime)) — Время последнего изменения столбца.
• column_ttl_min (Nullable(DateTime)) — Минимальное значение вычисленного TTL-выражения для столбца.
• column_ttl_max (Nullable(DateTime)) — Максимальное значение вычисляемого TTL-выражения для столбца.
• statistics (Array(String)) — Статистика столбца.
• estimates.min (Nullable(String)) — Предполагаемое минимальное значение столбца.
• estimates.max (Nullable(String)) — Предполагаемое максимальное значение столбца.
• estimates.cardinality (Nullable(UInt64)) — Приблизительная мощность столбца.
• estimates.null_count (Nullable(UInt64)) — Оценочное число значений NULL в столбце.
• serialization_kind (String) — Тип сериализации столбца
• substreams (Array(String)) — Названия подпотоков, в которые сериализуется столбец
• filenames (Array(String)) — Имена файлов для каждого подпотока столбца
• subcolumns.names (Array(String)) — Названия подстолбцов столбца
• subcolumns.types (Array(String)) — Типы подстолбцов столбца
• subcolumns.serializations (Array(String)) — Типы сериализации подстолбцов столбца
• subcolumns.bytes_on_disk (Array(UInt64)) — Размеры в байтах для каждого подстолбца
• subcolumns.data_compressed_bytes (Array(UInt64)) — Размеры сжатых данных для каждого подстолбца в байтах
• subcolumns.data_uncompressed_bytes (Array(UInt64)) — Размер распакованных данных для каждого подстолбца, в байтах
• subcolumns.marks_bytes (Array(UInt64)) — Размеры меток для каждого подстолбца столбца, в байтах

​

Пример

SELECT * FROM system.parts_columns LIMIT 1 FORMAT Vertical;

Row 1:
──────
partition:                             tuple()
name:                                  all_1_2_1
part_type:                             Wide
active:                                1
marks:                                 2
rows:                                  2
bytes_on_disk:                         155
data_compressed_bytes:                 56
data_uncompressed_bytes:               4
marks_bytes:                           96
modification_time:                     2020-09-23 10:13:36
remove_time:                           2106-02-07 06:28:15
refcount:                              1
min_date:                              1970-01-01
max_date:                              1970-01-01
partition_id:                          all
min_block_number:                      1
max_block_number:                      2
level:                                 1
data_version:                          1
primary_key_bytes_in_memory:           2
primary_key_bytes_in_memory_allocated: 64
database:                              default
table:                                 53r93yleapyears
engine:                                MergeTree
disk_name:                             default
path:                                  /var/lib/clickhouse/data/default/53r93yleapyears/all_1_2_1/
column:                                id
type:                                  Int8
column_position:                       1
default_kind:
default_expression:
column_bytes_on_disk:                  76
column_data_compressed_bytes:          28
column_data_uncompressed_bytes:        2
column_marks_bytes:                    48

​

См. также

• Семейство MergeTree
• Подсчёт количества и размера частей compact и wide