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

文档中心

导航

part_log

最近更新时间：2025.07.02 15:12:58首次发布时间：2025.07.02 15:12:58

system.part_log 表仅在指定了 part_log 服务器设置时才会创建。该表包含有关在 MergeTree 家族表中发生的 data parts 事件的信息，例如添加或合并数据。在首次向 MergeTree 表插入数据后，会创建 system.part_log 表。

列名

字段名称	数据类型	字段含义说明
query_id	String	创建该数据 part 的 `INSERT` 查询的标识符。
event_type	Enum8	与数据 part 发生的事件的类型。可以有以下值之一： `NewPart` — 插入新数据 part 。 `MergePartsStart` — 数据 part 的合并已开始。 `MergeParts` — 数据 part 的合并已完成。 `DownloadPart` — 正在下载数据 part 。 `RemovePart` — 使用 DETACH PARTITION 删除或分离数据 part 。 `MutatePartStart` — 数据 part 的变更已开始。 `MutatePart` — 数据 part 的变更已完成。 `MovePart` — 将数据 part 从一个磁盘移动到另一个磁盘。
event_date	Date	事件日期。
event_time	DateTime	事件时间。
event_time_microseconds	DateTime64	事件时间，精确到微秒。
duration_ms	UInt64	持续时间。
database	String	数据 part 所在的数据库名称。
table	String	数据 part 所在的表名称。
part_name	String	数据 part 的名称。
partition_id	String	数据 part 插入到的分区的 ID。如果分区是根据 `tuple()` 进行的，则该列取值为 `all`。
bucket_id	String	数据 part 使用的分桶 ID。
partition	String	分区键。
path_on_disk	String	数据 part 文件的文件夹的绝对路径。
rows	UInt64	数据 part 中的行数。
size_in_bytes	UInt64	数据 part 的大小（以字节为单位）。
merged_from	Array(String)	当前 part 由哪些 part 组成的名称数组（合并后）。
bytes_uncompressed	UInt64	未压缩字节的大小。
read_rows	UInt64	在合并过程中读取的行数。
read_bytes	UInt64	在合并过程中读取的字节数。
peak_memory_usage	Int64	在此线程上下文中分配和释放内存的最大差异。
error	UInt16	发生错误的代码。
exception	String	发生错误的文本消息。

示例

SELECT * FROM system.part_log LIMIT 1 FORMAT Vertical;

Row 1:
──────
query_id:                      983ad9c7-28d5-4ae1-844e-603116b7de31
event_type:                    NewPart
event_date:                    2021-02-02
event_time:                    2021-02-02 11:14:28
event_time_microseconds:       2021-02-02 11:14:28.861919
duration_ms:                   35
database:                      default
table:                         log_mt_2
part_name:                     all_1_1_0
partition_id:                  all
bucket_id:                     -1
partition:                     tuple()
path_on_disk:                  db/data/default/log_mt_2/all_1_1_0/
rows:                          115418
size_in_bytes:                 1074311
merged_from:                   []
bytes_uncompressed:            0
read_rows:                     0
read_bytes:                    0
peak_memory_usage:             0
error:                         0
exception:                     ""