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) — ID партиции.
• 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 в столбце.
• estimates.default_count (Nullable(UInt64)) — Оценочное количество строк со значением по умолчанию для хранения в столбце (NULL для столбцов с типом Nullable, 0 / ” / [] / … для столбцов без Nullable). 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)) — Размер меток каждого подстолбца столбца в байтах

Псевдонимы:

• bytes — псевдоним bytes_on_disk.
• marks_size — псевдоним marks_bytes.
• part_name — псевдоним name.

​

Пример

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