> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> 包含 MergeTree 表中 parts 和列信息的系统表。

# system.parts_columns

<div id="description">
  ## 描述
</div>

包含有关 [MergeTree](/zh/reference/engines/table-engines/mergetree-family/mergetree) 表的 parts 和列的信息。
每一行对应一个数据分区片段。

<div id="columns">
  ## 列
</div>

* `partition` ([String](/zh/reference/data-types)) — 分区名。
* `name` ([String](/zh/reference/data-types)) — 数据分区片段名称。
* `uuid` ([UUID](/zh/reference/data-types)) — parts 的 UUID。
* `part_type` ([String](/zh/reference/data-types)) — 数据分区片段的存储格式。可选值：Wide — 每一列都存储在文件系统中的单独文件中，Compact — 所有列都存储在文件系统中的同一个文件中。
* `active` ([UInt8](/zh/reference/data-types)) — 用于指示数据分区片段是否为活动状态的标志。如果某个数据分区片段处于活动状态，则会在表中使用；否则会被删除。非活动的数据分区片段在合并后仍会保留。
* `marks` ([UInt64](/zh/reference/data-types)) — 标记数。要获得一个数据分区片段中的近似行数，可将标记数乘以索引粒度 (通常为 8192)  (此方法不适用于自适应粒度) 。
* `rows` ([UInt64](/zh/reference/data-types)) — 行数。
* `bytes_on_disk` ([UInt64](/zh/reference/data-types)) — 所有数据分区片段文件的总大小，单位为字节。
* `data_compressed_bytes` ([UInt64](/zh/reference/data-types)) — 数据分区片段中压缩数据的总大小。不包括任何辅助文件 (例如，标记文件) 。
* `data_uncompressed_bytes` ([UInt64](/zh/reference/data-types)) — 数据分区片段中未压缩数据的总大小。不包括任何辅助文件 (例如，标记文件) 。
* `marks_bytes` ([UInt64](/zh/reference/data-types)) — 标记文件的大小。
* `modification_time` ([DateTime](/zh/reference/data-types)) — 包含数据分区片段的目录的修改时间。通常对应于数据分区片段的创建时间。
* `remove_time` ([DateTime](/zh/reference/data-types)) — 数据分区片段变为非活跃状态的时间。
* `refcount` ([UInt32](/zh/reference/data-types)) — 数据分区片段被使用的地方数量。值大于 2 表示该数据分区片段在查询或合并过程中被使用。
* `min_date` ([Date](/zh/reference/data-types)) — 如果该列包含在分区键中，则表示 Date 列的最小值。
* `max_date` ([Date](/zh/reference/data-types)) — 如果分区键中包含 Date 列，则表示该列的最大值。
* `min_time` ([DateTime](/zh/reference/data-types)) — 如果分区键中包含 DateTime 列，则表示该列的最小值。
* `max_time` ([DateTime](/zh/reference/data-types)) — 如果 DateTime 列包含在分区键中，则表示该列的最大值。
* `partition_id` ([String](/zh/reference/data-types)) — 分区 ID。
* `min_block_number` ([Int64](/zh/reference/data-types)) — 合并后组成当前数据分区片段的各数据分区片段中的最小编号。
* `max_block_number` ([Int64](/zh/reference/data-types)) — 合并后构成当前数据分区片段的各数据分区片段中的最大编号。
* `level` ([UInt32](/zh/reference/data-types)) — 合并树的深度。0 表示当前 part 是通过 insert 创建的，而不是由其他 parts 合并而来。
* `data_version` ([UInt64](/zh/reference/data-types)) — 用于确定哪些变更应应用于该数据分区片段的数值 (版本高于 data\_version 的变更) 。
* `primary_key_bytes_in_memory` ([UInt64](/zh/reference/data-types)) — 主键值占用的内存量 (以字节为单位) 。
* `primary_key_bytes_in_memory_allocated` ([UInt64](/zh/reference/data-types)) — 为主键值预留的内存大小 (以字节为单位) 。
* `database` ([String](/zh/reference/data-types)) — 数据库名称。
* `table` ([String](/zh/reference/data-types)) — 表名称。
* `engine` ([String](/zh/reference/data-types)) — 不含参数的表引擎名称。
* `disk_name` ([String](/zh/reference/data-types)) — 用于存储该数据分区片段的磁盘名称。
* `path` ([String](/zh/reference/data-types)) — 存放数据分区片段文件的文件夹的绝对路径。
* `column` ([String](/zh/reference/data-types)) — 列名。
* `type` ([String](/zh/reference/data-types)) — 列的数据类型。
* `column_position` ([UInt64](/zh/reference/data-types)) — 表中列的序号位置，从 1 开始计数。
* `default_kind` ([String](/zh/reference/data-types)) — 默认值的表达式类型 (DEFAULT、MATERIALIZED、ALIAS) ；如果未定义，则为空字符串。
* `default_expression` ([String](/zh/reference/data-types)) — 默认值表达式；如果未定义，则为空字符串。
* `column_bytes_on_disk` ([UInt64](/zh/reference/data-types)) — 该列的总大小，以字节为单位。
* `column_data_compressed_bytes` ([UInt64](/zh/reference/data-types)) — 列中压缩数据的总字节数。
* `column_data_uncompressed_bytes` ([UInt64](/zh/reference/data-types)) — 列中解压后数据的总大小，单位为字节。
* `column_marks_bytes` ([UInt64](/zh/reference/data-types)) — 列标记的大小 (以字节为单位) 。
* `column_modification_time` ([Nullable(DateTime)](/zh/reference/data-types)) — 该列上次修改的时间。
* `column_ttl_min` ([Nullable(DateTime)](/zh/reference/data-types)) — 该列计算得出的生存时间 (TTL) 表达式的最小值。
* `column_ttl_max` ([Nullable(DateTime)](/zh/reference/data-types)) — 该列计算所得生存时间 (TTL) 表达式的最大值。
* `statistics` ([Array(String)](/zh/reference/data-types)) — 列的统计信息。
* `estimates.min` ([Nullable(String)](/zh/reference/data-types)) — 列的估计最小值。
* `estimates.max` ([Nullable(String)](/zh/reference/data-types)) — 该列的估计最大值。
* `estimates.cardinality` ([Nullable(UInt64)](/zh/reference/data-types)) — 该列的预估基数。
* `estimates.null_count` ([Nullable(UInt64)](/zh/reference/data-types)) — 列中 NULL 值的预估数量。
* `serialization_kind` ([String](/zh/reference/data-types)) — 列的序列化方式
* `substreams` ([Array(String)](/zh/reference/data-types)) — 列序列化到的子流名称
* `filenames` ([Array(String)](/zh/reference/data-types)) — 该列各个子流对应的文件名
* `subcolumns.names` ([Array(String)](/zh/reference/data-types)) — 列的子列名称
* `subcolumns.types` ([Array(String)](/zh/reference/data-types)) — 某列的子列类型
* `subcolumns.serializations` ([Array(String)](/zh/reference/data-types)) — 列的子列的序列化类型
* `subcolumns.bytes_on_disk` ([Array(UInt64)](/zh/reference/data-types)) — 每个子列的大小 (单位：字节)
* `subcolumns.data_compressed_bytes` ([Array(UInt64)](/zh/reference/data-types)) — 各子列压缩数据的大小 (以字节为单位)
* `subcolumns.data_uncompressed_bytes` ([Array(UInt64)](/zh/reference/data-types)) — 各子列解压后数据的大小，以字节为单位
* `subcolumns.marks_bytes` ([Array(UInt64)](/zh/reference/data-types)) — 某列中每个子列的标记大小 (以字节为单位)

<div id="example">
  ## 示例
</div>

```sql theme={null}
SELECT * FROM system.parts_columns LIMIT 1 FORMAT Vertical;
```

```text theme={null}
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
```

<div id="see-also">
  ## 另请参阅
</div>

* [MergeTree 家族](/zh/reference/engines/table-engines/mergetree-family/mergetree)
* [计算 compact 和 wide parts 的数量及大小](/zh/resources/support-center/knowledge-base/troubleshooting/count-parts-by-type)