> ## 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.
> Tabela de sistema que contém informações sobre eventos ocorridos com partes de dados nas tabelas da família MergeTree, como adição ou mesclagem de dados.
# system.part_log
**Consultas no ClickHouse Cloud**
Os dados nesta tabela de sistema são mantidos localmente em cada nó do ClickHouse Cloud. Portanto, para obter uma visão completa de todos os dados, é necessário usar a função `clusterAllReplicas`. Consulte [aqui](/pt-BR/reference/system-tables/overview#system-tables-in-clickhouse-cloud) para mais detalhes.
## Descrição
A tabela `system.part_log` é criada somente se a configuração do servidor [part\_log](/pt-BR/reference/settings/server-settings/settings#part_log) estiver definida.
Esta tabela contém informações sobre eventos ocorridos com [partes de dados](/pt-BR/reference/engines/table-engines/mergetree-family/custom-partitioning-key) em tabelas da família [MergeTree](/pt-BR/reference/engines/table-engines/mergetree-family/mergetree), como adição ou mesclagem de dados.
A tabela `system.part_log` contém as seguintes colunas:
## Colunas
* `hostname` ([LowCardinality(String)](/pt-BR/reference/data-types/lowcardinality)) — Nome do host do servidor que executa a consulta.
* `query_id` ([String](/pt-BR/reference/data-types/string)) — Identificador da consulta INSERT que criou esta parte de dados.
* `event_type` ([Enum8('NewPart' = 1, 'MergeParts' = 2, 'DownloadPart' = 3, 'RemovePart' = 4, 'MutatePart' = 5, 'MovePart' = 6, 'MergePartsStart' = 7, 'MutatePartStart' = 8)](/pt-BR/reference/data-types/enum)) — Tipo do evento que ocorreu com a parte de dados. Pode ter um dos seguintes valores: NewPart — Inserção de uma nova parte de dados, MergePartsStart — A mesclagem das partes de dados foi iniciada, MergeParts — A mesclagem das partes de dados foi concluída, DownloadPart — Download de uma parte de dados, RemovePart — Remoção ou desanexação de uma parte de dados usando [DETACH PARTITION](/pt-BR/reference/statements/alter/partition#detach-partitionpart).MutatePartStart — A mutação de uma parte de dados foi iniciada, MutatePart — A mutação de uma parte de dados foi concluída, MovePart — Movimentação da parte de dados de um disco para outro.
* `merge_reason` ([Enum8('NotAMerge' = 1, 'RegularMerge' = 2, 'TTLDeleteMerge' = 3, 'TTLRecompressMerge' = 4, 'TTLDropMerge' = 5)](/pt-BR/reference/data-types/enum)) — O motivo do evento do tipo MERGE\_PARTS. Pode ter um dos seguintes valores: NotAMerge — O evento atual tem um tipo diferente de MERGE\_PARTS, RegularMerge — Um merge comum, TTLDeleteMerge, TTLDropMerge — Limpeza de dados expirados. TTLRecompressMerge — Recompressão da parte de dados com o.
* `merge_algorithm` ([Enum8('Undecided' = 0, 'Vertical' = 1, 'Horizontal' = 2)](/pt-BR/reference/data-types/enum)) — Algoritmo de mesclagem para o evento do tipo MERGE\_PARTS. Pode ter um dos seguintes valores: Undecided, Horizontal, Vertical
* `event_date` ([Date](/pt-BR/reference/data-types/date)) — Data do evento.
* `event_time` ([DateTime](/pt-BR/reference/data-types/datetime)) — Data e hora do evento.
* `event_time_microseconds` ([DateTime64(6)](/pt-BR/reference/data-types/datetime64)) — Horário do evento com precisão de microssegundos.
* `duration_ms` ([UInt64](/pt-BR/reference/data-types/int-uint)) — Duração dessa operação.
* `database` ([String](/pt-BR/reference/data-types/string)) — Nome do banco de dados ao qual a parte de dados pertence.
* `table` ([String](/pt-BR/reference/data-types/string)) — Nome da tabela à qual a parte de dados pertence.
* `table_uuid` ([UUID](/pt-BR/reference/data-types/uuid)) — UUID da tabela à qual a parte de dados pertence.
* `part_name` ([String](/pt-BR/reference/data-types/string)) — Nome da parte de dados.
* `partition_id` ([String](/pt-BR/reference/data-types/string)) — ID da partição em que a parte de dados foi inserida. A coluna assume o valor `all` se o particionamento for por `tuple()`.
* `partition` ([String](/pt-BR/reference/data-types/string)) — O nome da partição.
* `part_type` ([String](/pt-BR/reference/data-types/string)) — O tipo da parte. Valores possíveis: Wide e Compact.
* `part_storage_type` ([String](/pt-BR/reference/data-types/string)) — O tipo de DataPartStorage. Valores possíveis: Packed - todos os arquivos são armazenados em um único blob, Full - um blob para cada arquivo.
* `disk_name` ([String](/pt-BR/reference/data-types/string)) — O nome do disco em que a parte de dados se encontra.
* `path_on_disk` ([String](/pt-BR/reference/data-types/string)) — Caminho absoluto da pasta que contém os arquivos da parte de dados.
* `rows` ([UInt64](/pt-BR/reference/data-types/int-uint)) — O número de linhas na parte de dados.
* `size_in_bytes` ([UInt64](/pt-BR/reference/data-types/int-uint)) — Tamanho da parte de dados no disco, em bytes.
* `merged_from` ([Array(String)](/pt-BR/reference/data-types/array)) — Um array com os nomes das partes de origem a partir das quais a parte atual foi formada.
* `bytes_uncompressed` ([UInt64](/pt-BR/reference/data-types/int-uint)) — Tamanho descompactado da parte resultante, em bytes.
* `read_rows` ([UInt64](/pt-BR/reference/data-types/int-uint)) — Número de linhas lidas durante a mesclagem.
* `read_bytes` ([UInt64](/pt-BR/reference/data-types/int-uint)) — O número de bytes lidos durante a mesclagem.
* `peak_memory_usage` ([UInt64](/pt-BR/reference/data-types/int-uint)) — A quantidade máxima de RAM usada durante a operação de merge
* `deduplication_block_ids` ([Array(String)](/pt-BR/reference/data-types/array)) — Um array de IDs de bloco usado na desduplicação ao inserir esta parte.
* `error` ([UInt16](/pt-BR/reference/data-types/int-uint)) — O código de erro da exceção gerada.
* `exception` ([String](/pt-BR/reference/data-types/string)) — Mensagem de texto do erro ocorrido.
* `mutation_ids` ([Array(String)](/pt-BR/reference/data-types/array)) — Um array de IDs de mutação aplicados à parte de origem (merged\_from) para o evento do tipo MUTATE\_PART\_START e MUTATE\_PART.
* `ProfileEvents` ([Map(LowCardinality(String), UInt64)](/pt-BR/reference/data-types/map)) — Todos os eventos de perfil coletados durante esta operação.
* `projections_duration_ms` ([Map(LowCardinality(String), UInt64)](/pt-BR/reference/data-types/map)) — Duração, em milissegundos, da mesclagem/reconstrução de cada projeção.
**Aliases:**
* `ProfileEvents.Names` — é um alias de `mapKeys(ProfileEvents)`.
* `ProfileEvents.Values` — é um alias de `mapValues(ProfileEvents)`.
* `name` — é um alias de `part_name`.
A tabela `system.part_log` é criada após a primeira inserção de dados na tabela `MergeTree`.
## Exemplo
```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 -- 3.29 million
size_in_bytes: 438968542 -- 438.97 million
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 -- 1.37 billion
read_rows: 3285726 -- 3.29 million
read_bytes: 1429206946 -- 1.43 billion
peak_memory_usage: 303611887 -- 303.61 million
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}
```