You need to enable JavaScript to run this app.
导航
parts_columns
最近更新时间:2025.07.02 15:12:58首次发布时间:2025.07.02 15:12:58
复制全文
我的收藏
有用
有用
无用
无用

parts_columns 包含有关 MergeTree 表的 parts 和列的信息。每行描述一个数据 part 。

列名

字段名称

数据类型

字段含义说明

partition

String

分区名称。分区的定义请参见分区操作(PARTITION)的描述。
格式:

  • YYYYMM 用于按月自动分区。
  • any_string 用于手动分区。

name

String

数据 part 的名称。

uuid

UUID

数据 part 的 UUID。

part_type

String

数据 part 的存储格式。支持的值如下:

  • Wide — 每列在文件系统中存储在单独的文件中。
  • Compact — 所有列在文件系统中存储在一个文件中。

数据存储格式由 MergeTree 表的 min_bytes_for_wide_partmin_rows_for_wide_part 设置控制。

active

UInt8

指示数据 part 是否处于活动状态的标志。如果数据 part 处于活动状态,则在表中使用。否则,它会被删除。非活动数据 part 在合并后仍然存在。

marks

UInt64

稀疏索引数量。要获得数据 part 中行的近似数量,请将 marks 乘以索引粒度(通常为 8192)(此提示不适用于自适应粒度)。

rows

UInt64

行数。

bytes_on_disk

UInt64

数据 part 文件的总大小(单位:字节)。

data_compressed_bytes

UInt64

数据 part 中压缩数据的总大小。所有辅助文件(例如,稀疏索引文件)不包括在内。

data_uncompressed_bytes

UInt64

数据 part 中未压缩数据的总大小。所有辅助文件(例如,稀疏索引文件)不包括在内。

marks_bytes

UInt64

含有稀疏索引的文件的大小。

modification_time

DateTime

修改数据 part 目录的时间。这通常与数据 part 创建的时间相对应。

remove_time

DateTime

数据 part 变为非活动状态的时间。

refcount

UInt32

数据 part 被使用的次数。如果值大于 2,说明数据 part 在查询或合并中使用。

min_date

Date

数据 part 中日期键的最小值。

max_date

Date

数据 part 中日期键的最大值。

min_time

DateTime

数据 part 中时间键的最小值。

max_time

DateTime

数据 part 中时间键的最大值。

partition_id

String

分区的 ID。

min_block_number

UInt64

合并后构成当前 part 的数据 part 的最小数量。

max_block_number

UInt64

合并后构成当前 part 的数据 part 的最大数量。

level

UInt32

合并树的深度。零表示当前 part 是通过插入而不是通过合并其他 part 创建的。

data_version

UInt64

用于确定应用于数据 part 的变更的版本号(版本高于 data_version 的变更)。

primary_key_bytes_in_memory

UInt64

主键值占用的内存量(单位:字节)。

primary_key_bytes_in_memory_allocated

UInt64

为主键值保留的内存量(单位:字节)。

database

String

数据库名称。

table

String

表名称。

engine

String

表引擎名称(不带参数)。

disk_name

String

存储数据 part 的磁盘名称。

path

String

数据 part 文件夹的绝对路径。

delete_rows

UInt64

数据 part 中已经被删除的行数,常见于 HaUniqueMergeTree 引擎存储的 part 中。

delete_version

UInt64

此 part 最新 delete bitmap 的版本

unique_index_size

UInt64

memory unique index 里的元素个数。

unique_index_bytes_in_memeory

UInt64

memory unique index 所占的内存,如果是 disk unique index,该值为 0。

has_disk_unique_index

UInt8

unique index 的类型是否是 disk unique index,值为 false 代表 memory unique index,true 代表 disk unique index。

unique_part_format_version

Int8

无。

column

String

列名称。

type

String

列类型。

column_position

UInt64

表中列的序号,从 1 开始。

default_kind

String

默认值的表达式类型(DEFAULTMATERIALIZEDALIAS),如果未定义则为空字符串。

default_expression

String

默认值的表达式,如果未定义则为空字符串。

column_bytes_on_disk

UInt64

列的总大小(以字节为单位)。

column_data_compressed_bytes

UInt64

列中压缩数据的总大小(以字节为单位)。

column_data_uncompressed_bytes

UInt64

列中未压缩数据的总大小(以字节为单位)。

column_marks_bytes

UInt64

含有稀疏索引的列的大小(以字节为单位)。

bucket_id

Int32

分桶 ID

serialization_kind

String

序列化的类型(Default/Sparse)。

subcolumns.names

Array(String)

嵌套类型子列的名字。

subcolumns.types

Array(String)

嵌套类型子列的类型。

subcolumns.serializations

Array(String)

嵌套类型子列的序列化方式。

subcolumns.bytes_on_disk

Array(UInt64)

此 part 下嵌套类型子列的文件大小(单位:字节)。

subcolumns.data_compressed_bytes

Array(UInt64)

此 part 下嵌套类型子列的压缩数据的总大小。所有辅助文件(例如,稀疏索引文件)不包括在内。

subcolumns.data_uncompressed_bytes

Array(UInt64)

此 part 下嵌套类型子列的未压缩数据的总大小。所有辅助文件(例如,稀疏索引文件)不包括在内。

subcolumns.marks_bytes

Array(UInt64)

此 part 下嵌套类型子列的稀疏索引的文件的大小。

bytes

UInt64

bytes_on_disk 的别名。

marks_size

UInt64

marks_bytes 的别名。

示例

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/
delete_rows:                           0
delete_versions:                       0
unique_index_size:                     0
unique_index_bytes_in_memory:          0
has_dish_unique_index:                 0
unique_part_format_version:            0
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
bucket_id:                             -1
serialization_kind:                    default
subcolumns.names:                      []
subcolumns.types:                      []
subcolumns.serialization:              []
subcolumns.bytes_on_disk:              []
subcolumns.data_compressed_bytes:      []
subcolumns.data_uncompressed_bytes:    []
subcolumns.marks_bytes:                []