> ## 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 家族表中数据分区片段事件信息的系统表，例如数据的添加或合并。

# system.part_log

<Info>
  **在 ClickHouse Cloud 中查询**

  此系统表中的数据分别保存在 ClickHouse Cloud 各节点的本地。因此，如需查看所有数据的完整情况，需要使用 `clusterAllReplicas` 函数。更多详情请参见[此处](/zh/reference/system-tables/overview#system-tables-in-clickhouse-cloud)。
</Info>

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

仅当指定了 [part\_log](/zh/reference/settings/server-settings/settings#part_log) 服务器设置时，才会创建 `system.part_log` 表。

此表包含 [MergeTree](/zh/reference/engines/table-engines/mergetree-family/mergetree) 家族表中与 [数据分区片段](/zh/reference/engines/table-engines/mergetree-family/custom-partitioning-key) 相关的事件信息，例如添加数据或合并数据。

`system.part_log` 表包含以下列：

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

* `hostname` ([LowCardinality(String)](/zh/reference/data-types/lowcardinality)) — 执行该查询的服务器主机名。
* `query_id` ([String](/zh/reference/data-types/string)) — 创建此数据分区片段的 INSERT 查询标识符。
* `event_type` ([Enum8('NewPart' = 1, 'MergeParts' = 2, 'DownloadPart' = 3, 'RemovePart' = 4, 'MutatePart' = 5, 'MovePart' = 6, 'MergePartsStart' = 7, 'MutatePartStart' = 8)](/zh/reference/data-types/enum)) — 发生在数据分区片段上的事件类型。可能具有以下值之一：NewPart — 插入新的数据分区片段，MergePartsStart — 数据分区片段的合并已开始，MergeParts — 数据分区片段的合并已完成，DownloadPart — 下载数据分区片段，RemovePart — 使用 [DETACH PARTITION](/zh/reference/statements/alter/partition#detach-partitionpart) 删除或分离数据分区片段。MutatePartStart — 数据分区片段的变更已开始，MutatePart — 数据分区片段的变更已完成，MovePart — 将数据分区片段从一个磁盘移动到另一个磁盘。
* `merge_reason` ([Enum8('NotAMerge' = 1, 'RegularMerge' = 2, 'TTLDeleteMerge' = 3, 'TTLRecompressMerge' = 4, 'TTLDropMerge' = 5)](/zh/reference/data-types/enum)) — `MERGE_PARTS` 类型事件发生的原因。可能具有以下值之一：NotAMerge — 当前事件的类型不是 `MERGE_PARTS`；RegularMerge — 常规合并；TTLDeleteMerge、TTLDropMerge — 清理过期数据；TTLRecompressMerge — 重新压缩数据分区片段。
* `merge_algorithm` ([Enum8('Undecided' = 0, 'Vertical' = 1, 'Horizontal' = 2)](/zh/reference/data-types/enum)) — 类型为 MERGE\_PARTS 的事件所使用的合并算法。可取以下值之一：Undecided、Horizontal、Vertical
* `event_date` ([Date](/zh/reference/data-types/date)) — 事件日期。
* `event_time` ([DateTime](/zh/reference/data-types/datetime)) — 事件发生时间。
* `event_time_microseconds` ([DateTime64(6)](/zh/reference/data-types/datetime64)) — 精确到微秒的事件时间。
* `duration_ms` ([UInt64](/zh/reference/data-types/int-uint)) — 此操作的耗时。
* `database` ([String](/zh/reference/data-types/string)) — 该数据分区片段所在数据库的名称。
* `table` ([String](/zh/reference/data-types/string)) — 数据分区片段所在表的名称。
* `table_uuid` ([UUID](/zh/reference/data-types/uuid)) — 该数据分区片段所属的表的 UUID。
* `part_name` ([String](/zh/reference/data-types/string)) — 数据分区片段名称。
* `partition_id` ([String](/zh/reference/data-types/string)) — 数据分区片段被插入到的分区 ID。若按 `tuple()` 进行分区，则该列的值为 `all`。
* `partition` ([String](/zh/reference/data-types/string)) — 分区名称。
* `part_type` ([String](/zh/reference/data-types/string)) — 分片类型。可选值：Wide 和 Compact。
* `part_storage_type` ([String](/zh/reference/data-types/string)) — DataPartStorage 的类型。可能的值：Packed - 所有文件都存储在同一个 blob 中，Full - 每个文件对应一个 blob。
* `disk_name` ([String](/zh/reference/data-types/string)) — 数据分区片段所在磁盘的名称。
* `path_on_disk` ([String](/zh/reference/data-types/string)) — 存放数据分区片段文件的文件夹的绝对路径。
* `rows` ([UInt64](/zh/reference/data-types/int-uint)) — 数据分区片段中的行数。
* `size_in_bytes` ([UInt64](/zh/reference/data-types/int-uint)) — 数据分区片段在磁盘上占用的大小 (以字节为单位) 。
* `merged_from` ([Array(String)](/zh/reference/data-types/array)) — 包含组成当前 part 的源 parts 名称的数组。
* `bytes_uncompressed` ([UInt64](/zh/reference/data-types/int-uint)) — 结果分片的未压缩大小 (字节) 。
* `read_rows` ([UInt64](/zh/reference/data-types/int-uint)) — 合并过程中读取的行数。
* `read_bytes` ([UInt64](/zh/reference/data-types/int-uint)) — 合并期间读取的字节数。
* `peak_memory_usage` ([UInt64](/zh/reference/data-types/int-uint)) — 合并期间的最大 RAM 使用量
* `deduplication_block_ids` ([Array(String)](/zh/reference/data-types/array)) — 在插入此分片时用于去重的块 ID 数组。
* `error` ([UInt16](/zh/reference/data-types/int-uint)) — 已发生的异常的错误代码。
* `exception` ([String](/zh/reference/data-types/string)) — 已发生错误的文本消息。
* `mutation_ids` ([Array(String)](/zh/reference/data-types/array)) — 对于类型为 MUTATE\_PART\_START 和 MUTATE\_PART 的事件，这是应用到源分片 (merged\_from) 上的变更 ID 数组。
* `ProfileEvents` ([Map(LowCardinality(String), UInt64)](/zh/reference/data-types/map)) — 此操作期间记录的所有 profile events。
* `projections_duration_ms` ([Map(LowCardinality(String), UInt64)](/zh/reference/data-types/map)) — 各投影合并/重建的耗时 (毫秒) 。

**别名：**

* `ProfileEvents.Names` — `mapKeys(ProfileEvents)` 的别名。
* `ProfileEvents.Values` — `mapValues(ProfileEvents)` 的别名。
* `name` — `part_name` 的别名。

`system.part_log` 表会在首次向 `MergeTree` 表中插入数据后创建。

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

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

```text theme={null}
Row 1:
──────
hostname:                clickhouse.eu-central1.internal
query_id:
event_type:              MergeParts
merge_reason:            RegularMerge
merge_algorithm:         Vertical
event_date:              2025-07-19
event_time:              2025-07-19 23:54:19
event_time_microseconds: 2025-07-19 23:54:19.710761
duration_ms:             2158
database:                default
table:                   github_events
table_uuid:              1ad33424-f5f5-402b-ac03-ec82282634ab
part_name:               all_1_7_1
partition_id:            all
partition:               tuple()
part_type:               Wide
disk_name:               default
path_on_disk:            ./data/store/1ad/1ad33424-f5f5-402b-ac03-ec82282634ab/all_1_7_1/
rows:                    3285726 -- 329 万
size_in_bytes:           438968542 -- 4.3897 亿
merged_from:             ['all_1_1_0','all_2_2_0','all_3_3_0','all_4_4_0','all_5_5_0','all_6_6_0','all_7_7_0']
bytes_uncompressed:      1373137767 -- 13.7 亿
read_rows:               3285726 -- 329 万
read_bytes:              1429206946 -- 14.3 亿
peak_memory_usage:       303611887 -- 3.0361 亿
error:                   0
exception:
mutation_ids:
ProfileEvents:           {'FileOpen':703,'ReadBufferFromFileDescriptorRead':3824,'ReadBufferFromFileDescriptorReadBytes':439601681,'WriteBufferFromFileDescriptorWrite':592,'WriteBufferFromFileDescriptorWriteBytes':438988500,'ReadCompressedBytes':439601681,'CompressedReadBufferBlocks':6314,'CompressedReadBufferBytes':1539835748,'OpenedFileCacheHits':50,'OpenedFileCacheMisses':484,'OpenedFileCacheMicroseconds':222,'IOBufferAllocs':1914,'IOBufferAllocBytes':319810140,'ArenaAllocChunks':8,'ArenaAllocBytes':131072,'MarkCacheMisses':7,'CreatedReadBufferOrdinary':534,'DiskReadElapsedMicroseconds':139058,'DiskWriteElapsedMicroseconds':51639,'AnalyzePatchRangesMicroseconds':28,'ExternalProcessingFilesTotal':1,'RowsReadByMainReader':170857759,'WaitMarksLoadMicroseconds':988,'LoadedMarksFiles':7,'LoadedMarksCount':14,'LoadedMarksMemoryBytes':728,'Merge':2,'MergeSourceParts':14,'MergedRows':3285733,'MergedColumns':4,'GatheredColumns':51,'MergedUncompressedBytes':1429207058,'MergeTotalMilliseconds':2158,'MergeExecuteMilliseconds':2155,'MergeHorizontalStageTotalMilliseconds':145,'MergeHorizontalStageExecuteMilliseconds':145,'MergeVerticalStageTotalMilliseconds':2008,'MergeVerticalStageExecuteMilliseconds':2006,'MergeProjectionStageTotalMilliseconds':5,'MergeProjectionStageExecuteMilliseconds':4,'MergingSortedMilliseconds':7,'GatheringColumnMilliseconds':56,'ContextLock':2091,'PartsLockHoldMicroseconds':77,'PartsLockWaitMicroseconds':1,'RealTimeMicroseconds':2157475,'CannotWriteToWriteBufferDiscard':36,'LogTrace':6,'LogDebug':59,'LoggerElapsedNanoseconds':514040,'ConcurrencyControlSlotsGranted':53,'ConcurrencyControlSlotsAcquired':53}
```