mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-12-04 21:42:39 +00:00
91 lines
5.4 KiB
Markdown
91 lines
5.4 KiB
Markdown
---
|
||
slug: /zh/operations/system-tables/columns
|
||
---
|
||
# system.columns {#system-columns}
|
||
|
||
此系统表包含所有表中列的信息。
|
||
|
||
你可以使用这个表来获得类似于 [DESCRIBE TABLE](../../sql-reference/statements/misc.md#misc-describe-table) 查询的信息，但是可以同时获得多个表的信息。
|
||
|
||
[临时表](../../sql-reference/statements/create/table.mdx#temporary-tables)中的列只在创建它们的会话中的 `system.columns` 中才可见，并且它们的 `database` 字段显示为空。
|
||
|
||
`system.columns` 表包含以下列 (括号中显示的是列类型):
|
||
|
||
- `database` ([String](../../sql-reference/data-types/string.md)) — 数据库名称。
|
||
- `table` ([String](../../sql-reference/data-types/string.md)) — 表名。
|
||
- `name` ([String](../../sql-reference/data-types/string.md)) — 列名。
|
||
- `type` ([String](../../sql-reference/data-types/string.md)) — 列类型。
|
||
- `position` ([UInt64](../../sql-reference/data-types/int-uint.md)) — 列在表中的顺序位置，从1开始。
|
||
- `default_kind` ([String](../../sql-reference/data-types/string.md)) — 默认值的表达式类型(`DEFAULT`, `MATERIALIZED`, `ALIAS`) ，如果没有定义，则为空字符串。
|
||
- `default_expression` ([String](../../sql-reference/data-types/string.md)) — 默认值的表达式，如果未定义则为空字符串。
|
||
- `data_compressed_bytes` ([UInt64](../../sql-reference/data-types/int-uint.md)) — 压缩数据的大小，以字节为单位。
|
||
- `data_uncompressed_bytes` ([UInt64](../../sql-reference/data-types/int-uint.md)) — 解压后的数据的大小，以字节为单位。
|
||
- `marks_bytes` ([UInt64](../../sql-reference/data-types/int-uint.md)) — 标记的大小，以字节为单位。
|
||
- `comment` ([String](../../sql-reference/data-types/string.md)) — 列注释，如果没有定义，则为空字符串。
|
||
- `is_in_partition_key` ([UInt8](../../sql-reference/data-types/int-uint.md)) — 列是否在分区表达式中的标志。
|
||
- `is_in_sorting_key` ([UInt8](../../sql-reference/data-types/int-uint.md)) — 列是否在排序键表达式中的标志。
|
||
- `is_in_primary_key` ([UInt8](../../sql-reference/data-types/int-uint.md)) — 列是否在主键表达式中的标志。
|
||
- `is_in_sampling_key` ([UInt8](../../sql-reference/data-types/int-uint.md)) — 列是否在采样键表达式中的标志。
|
||
- `compression_codec` ([String](../../sql-reference/data-types/string.md)) — 压缩编码的名称。
|
||
- `character_octet_length` ([Nullable](../../sql-reference/data-types/nullable.md)([UInt64](../../sql-reference/data-types/int-uint.md))) — 二进制数据、字符数据或文本数据和图像的最大长度(以字节为单位)。在 ClickHouse 中只对 `FixedString` 数据类型有意义。否则，将返回 `NULL` 值。
|
||
- `numeric_precision` ([Nullable](../../sql-reference/data-types/nullable.md)([UInt64](../../sql-reference/data-types/int-uint.md))) — 近似数字型数据、精确数字型数据、整数型数据或货币数据的精度。在 ClickHouse 中，对于整数类型是比特率(bitness)，对于 `Decimal` 类型是十进制精度。否则，将返回 `NULL` 值。
|
||
- `numeric_precision_radix` ([Nullable](../../sql-reference/data-types/nullable.md)([UInt64](../../sql-reference/data-types/int-uint.md))) — 数字系统的基数是近似数字型数据、精确数字型数据、整数型数据或货币数据的精度。在 ClickHouse 中，对于整数类型是2，对于 `Decimal` 类型是10。否则，将返回 `NULL` 值。
|
||
- `numeric_scale` ([Nullable](../../sql-reference/data-types/nullable.md)([UInt64](../../sql-reference/data-types/int-uint.md))) — 近似数字型数据、精确数字型数据、整数型数据或货币数据的比例。在 ClickHouse 中只对 `Decimal` 类型有意义。否则，将返回 `NULL` 值。
|
||
- `datetime_precision` ([Nullable](../../sql-reference/data-types/nullable.md)([UInt64](../../sql-reference/data-types/int-uint.md))) — `DateTime64` 数据类型的小数精度。对于其他数据类型，将返回 `NULL` 值。
|
||
|
||
**示例**
|
||
|
||
```sql
|
||
SELECT * FROM system.columns LIMIT 2 FORMAT Vertical;
|
||
```
|
||
|
||
```text
|
||
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: ᴺᵁᴸᴸ
|
||
```
|