parts--ByteHouse 企业版-火山引擎

文档中心

导航

parts

最近更新时间：2025.07.04 11:24:51首次发布时间：2025.07.04 11:24:51

parts 包含了 MergeTree 表 parts 的信息。

列名

字段名称	数据类型	字段含义说明
partition	String	分区名称。格式如下： `YYYYMM` 用于按月份进行自动分区。 `any_string` 用于手动分区。
name	String	数据 part 的名称。part 命名结构可用于确定许多数据、摄取和合并模式方面。 part 命名格式如下： `<partition_id>_<minimum_block_number>_<maximum_block_number>_<level>_<data_version>` `partition_id` - 标识分区键。 `minimum_block_number` - 标识 part 中的最小块编号。ByteHouse 始终合并连续块。 `maximum_block_number` - 标识 part 中的最大块编号。 `level` - 每次额外合并时增加一。0 表示这是一个尚未合并的新 part。ByteHouse 中的所有 part 始终是不可变的。 `data_version` - 可选值，在 part 发生变更时递增。同样，变更的数据始终只写入新 part，因为 part 是不可变的。
uuid	UUID	数据 part 的 UUID。
part_type	String	数据 part 存储格式。可选值： `Wide` — 每列保存在文件系统中的单独文件中。 `Compact` — 所有列保存在文件系统中的一个文件中。数据存储格式由 MergeTree 表的 `min_bytes_for_wide_part` 和 `min_rows_for_wide_part` 设置控制。
active	UInt8	指示数据 part 是否处于活动状态的标志。如果数据 part 处于活动状态，则在表中使用。否则，已删除。在合并后，非活动的数据 part 仍然存在。
compact_map	UInt8	是否开启 compact map 功能。
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	Int64	合并后组成当前 part 的最小数据块编号。
max_block_number	Int64	合并后组成当前 part 的最大数据块编号。
level	UInt32	合并树的深度。零表示当前 part 是通过插入而非合并其他 part 创建的。
data_version	UInt64	用于确定应应用于数据 part 的哪些变更的号码（版本高于 `data_version` 的变更）。
primary_key_bytes_in_memory	UInt64	主键值使用的内存量（单位：字节）。
primary_key_bytes_in_memory_allocated	UInt64	为主键值保留的内存量（单位：字节）。
is_frozen	UInt8	显示分区数据备份是否存在的标志。支持以下数值： 1：备份存在。 0：备份不存在。
database	String	数据库名称。
table	String	表名称。
engine	String	不带参数的表引擎名称。
disk_name	String	存储数据 part 的磁盘名称。
path	String	数据 part 文件夹的绝对路径。
has_bitmap_index	Map(String, UInt8)	该 part 中 bitmap index 的构建情况。
total_index_cache_size	UInt64	该 part 中 index cache 所占内存大小，单位为 bytes。
delete_rows	UInt64	数据 part 中已经被删除的行数，常见于 HaUniqueMergeTree 引擎存储的 part 中。
delete_version	UInt64	此 part 最新 delete bitmap 的版本。
unique_index_size	UInt64	memory unique index 里的元素个数。
unique_index_bytes_in_memory	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	无。
hash_of_all_files	String	sipHash128 的压缩文件。
hash_of_uncompressed_files	String	sipHash128 的未压缩文件（带有标记的文件、索引文件等）。
uncompressed_hash_of_compressed_files	String	sipHash128 的压缩文件中数据的哈希，视为未压缩。
delete_ttl_info_min	DateTime	TTL DELETE 规则的日期和时间键的最小值。
delete_ttl_info_max	DateTime	TTL DELETE 规则的日期和时间键的最大值。
move_ttl_info.expression	Array(String)	表达式数组。每个表达式定义了一个 TTL MOVE 规则。说明 `move_ttl_info.expression` 数组主要为了向后兼容，现在检查 `TTL MOVE` 规则的最简单方法是使用 `move_ttl_info.min` 和 `move_ttl_info.max` 字段。
move_ttl_info.min	Array(DateTime)	日期和时间值数组。每个元素描述 TTL MOVE 规则的最小键值。
move_ttl_info.max	Array(DateTime)	日期和时间值数组。每个元素描述 TTL MOVE 规则的最大键值。
num_columns_encrypted	UInt64	part 中的加密列数量，开启表加密后有效。
bucket_id	Int32	分桶 ID。
bytes	UInt64	`bytes_on_disk` 的别名。
marks_size	UInt64	`marks_bytes` 的别名。

示例

SELECT * FROM system.parts LIMIT 1 FORMAT Vertical;

Row 1:
──────
partition:                             tuple()
name:                                  all_1_4_1_6
uuid:                                  00000000-0000-0000-0000-000000000000
part_type:                             Compact
active:                                1
compact_map:                           0
marks:                                 2
rows:                                  6
bytes_on_disk:                         330
data_compressed_bytes:                 123
data_uncompressed_bytes:               19
marks_bytes:                           144
modification_time:                     2020-06-18 13:01:49
remove_time:                           1970-01-01 00:00:00
refcount:                              1
min_date:                              1970-01-01
max_date:                              1970-01-01
min_time:                              1970-01-01 00:00:00
max_time:                              1970-01-01 00:00:00
partition_id:                          202503
min_block_number:                      1
max_block_number:                      4
level:                                 1
data_version:                          6
primary_key_bytes_in_memory:           8
primary_key_bytes_in_memory_allocated: 64
is_frozen:                             0
database:                              default
table:                                 local_aggregated_data
engine:                                AggregatingMergeTree
disk_name:                             default
path:                                  /var/lib/clickhouse/data/default/months/all_1_4_1_6/
has_bitmap_index:                      {}
total_index_cache_size:                0
delete_rows:                           0
delete_version:                        0
unique_index_size:                     0
unique_index_bytes_in_memory:          0
has_disk_unique_index:                 0
unique_part_format_version:            0
hash_of_all_files:                     2d0657a16d9430824d35e327fcbd87bf
hash_of_uncompressed_files:            84950cc30ba867c77a408ae21332ba29
uncompressed_hash_of_compressed_files: 1ad78f1c6843bbfb99a2c931abe7df7d
delete_ttl_info_min:                   1970-01-01 00:00:00
delete_ttl_info_max:                   1970-01-01 00:00:00
move_ttl_info.expression:              []
move_ttl_info.min:                     []
move_ttl_info.max:                     []
default_compression_codec:             LZ4
recompression_ttl_info.expression:     []
recompression_ttl_info.min:            []
recompression_ttl_info.max:            []
group_by_ttl_info.expression:          []
group_by_ttl_info.min:                 []
group_by_ttl_info.max:                 []
rows_where_ttl_info.expression:        []
rows_where_ttl_info.min:               []
rows_where_ttl_info.max:               []
only_keep_projection_parts:            0
num_columns_encrypted:                 0
bucket_id:                             -1