Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

system.columns

View as MarkdownEdit this pageReport an issueSet up docs MCP

描述

包含所有表中各列的信息。

你可以使用此表获取与 DESCRIBE TABLE 查询类似的信息，但可以一次查看多个表。

来自临时表的列，仅会在创建它们的那些 session 中显示在 system.columns 里。它们的 database 字段为空。

列

  • 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，Decimal 类型为 10；否则返回 NULL 值。
  • numeric_scale (Nullable(UInt64)) — 近似数值数据、精确数值数据、整数数据或货币数据的标度。在 ClickHouse 中，仅对 Decimal 类型有意义；否则返回 NULL 值。
  • datetime_precision (Nullable(UInt64)) — DateTime64 类型的小数精度。其他数据类型返回 NULL 值。
  • serialization_hint (Nullable(String)) — 根据统计信息为列选择 INSERT 时序列化方式的提示。
  • statistics (String) — 此列中创建的统计信息类型。

别名：

  • column — name 的别名。

示例

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:      ᴺᵁᴸᴸ
Navigation