system.columns

Содержит информацию о колонках во всех таблицах.

Вы можете использовать эту таблицу для получения информации, аналогичной запросу DESCRIBE TABLE, но для нескольких таблиц сразу.

Колонки из временных таблиц видны в system.columns только в тех сессиях, в которых они были созданы. Они отображаются с пустым полем database.

Таблица system.columns содержит следующие колонки (тип колонки указан в скобках):

database (String) — Название базы данных.
table (String) — Название таблицы.
name (String) — Название колонки.
type (String) — Тип колонки.
position (UInt64) — Позиция колонки в таблице, начиная с 1.
default_kind (String) — Тип выражения (DEFAULT, MATERIALIZED, ALIAS) для значения по умолчанию или пустая строка, если не определено.
default_expression (String) — Выражение для значения по умолчанию или пустая строка, если не определено.
data_compressed_bytes (UInt64) — Размер сжатых данных в байтах.
data_uncompressed_bytes (UInt64) — Размер декомпрессированных данных в байтах.
marks_bytes (UInt64) — Размер меток в байтах.
comment (String) — Комментарий к колонке или пустая строка, если не определено.
is_in_partition_key (UInt8) — Флаг, указывающий, находится ли колонка в выражении партиционирования.
is_in_sorting_key (UInt8) — Флаг, указывающий, находится ли колонка в выражении ключа сортировки.
is_in_primary_key (UInt8) — Флаг, указывающий, находится ли колонка в выражении первичного ключа.
is_in_sampling_key (UInt8) — Флаг, указывающий, находится ли колонка в выражении ключа выборки.
compression_codec (String) — Название кодека сжатия.
character_octet_length (Nullable(UInt64)) — Максимальная длина в байтах для двоичных данных, символьных данных или текстовых данных и изображений. В ClickHouse имеет смысл только для типа данных FixedString. В противном случае возвращается значение NULL.
numeric_precision (Nullable(UInt64)) — Точность приблизительных числовых данных, точных числовых данных, целых чисел или денежных данных. В ClickHouse это битовая ширина для целочисленных типов и десятичная точность для типов Decimal. В противном случае возвращается значение NULL.
numeric_precision_radix (Nullable(UInt64)) — Основание числовой системы, точность приблизительных числовых данных, точных числовых данных, целых чисел или денежных данных. В ClickHouse это 2 для целочисленных типов и 10 для типов Decimal. В противном случае возвращается значение NULL.
numeric_scale (Nullable(UInt64)) — Масштаб приблизительных числовых данных, точных числовых данных, целых чисел или денежных данных. В ClickHouse имеет смысл только для типов Decimal. В противном случае возвращается значение NULL.
datetime_precision (Nullable(UInt64)) — Десятичная точность типа данных DateTime64. Для других типов данных возвращается значение NULL.

Пример

SELECT * FROM system.columns LIMIT 2 FORMAT Vertical;

Row 1:
──────
database:                INFORMATION_SCHEMA
table:                   COLUMNS
name:                    table_catalog
type:                    String
position:                1
default_kind:
default_expression:
data_compressed_bytes:   0
data_uncompressed_bytes: 0
marks_bytes:             0
comment:
is_in_partition_key:     0
is_in_sorting_key:       0
is_in_primary_key:       0
is_in_sampling_key:      0
compression_codec:
character_octet_length:  ᴺᵁᴸᴸ
numeric_precision:       ᴺᵁᴸᴸ
numeric_precision_radix: ᴺᵁᴸᴸ
numeric_scale:           ᴺᵁᴸᴸ
datetime_precision:      ᴺᵁᴸᴸ

Row 2:
──────
database:                INFORMATION_SCHEMA
table:                   COLUMNS
name:                    table_schema
type:                    String
position:                2
default_kind:
default_expression:
data_compressed_bytes:   0
data_uncompressed_bytes: 0
marks_bytes:             0
comment:
is_in_partition_key:     0
is_in_sorting_key:       0
is_in_primary_key:       0
is_in_sampling_key:      0
compression_codec:
character_octet_length:  ᴺᵁᴸᴸ
numeric_precision:       ᴺᵁᴸᴸ
numeric_precision_radix: ᴺᵁᴸᴸ
numeric_scale:           ᴺᵁᴸᴸ
datetime_precision:      ᴺᵁᴸᴸ