Pular para o conteúdo principal
Consultas no ClickHouse CloudOs 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 para mais detalhes.

​
Descrição

A tabela system.part_log é criada somente se a configuração do servidor part_log estiver definida. Esta tabela contém informações sobre eventos ocorridos com partes de dados em tabelas da família MergeTree, como adição ou mesclagem de dados. A tabela system.part_log contém as seguintes colunas:

​
Colunas

  • hostname (LowCardinality(String)) — Nome do host do servidor que executa a consulta.
  • query_id (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)) — 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.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)) — 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)) — Algoritmo de mesclagem para o evento do tipo MERGE_PARTS. Pode ter um dos seguintes valores: Undecided, Horizontal, Vertical
  • event_date (Date) — Data do evento.
  • event_time (DateTime) — Data e hora do evento.
  • event_time_microseconds (DateTime64(6)) — Horário do evento com precisão de microssegundos.
  • duration_ms (UInt64) — Duração dessa operação.
  • database (String) — Nome do banco de dados ao qual a parte de dados pertence.
  • table (String) — Nome da tabela à qual a parte de dados pertence.
  • table_uuid (UUID) — UUID da tabela à qual a parte de dados pertence.
  • part_name (String) — Nome da parte de dados.
  • partition_id (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) — O nome da partição.
  • part_type (String) — O tipo da parte. Valores possíveis: Wide e Compact.
  • part_storage_type (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) — O nome do disco em que a parte de dados se encontra.
  • path_on_disk (String) — Caminho absoluto da pasta que contém os arquivos da parte de dados.
  • rows (UInt64) — O número de linhas na parte de dados.
  • size_in_bytes (UInt64) — Tamanho da parte de dados no disco, em bytes.
  • merged_from (Array(String)) — Um array com os nomes das partes de origem a partir das quais a parte atual foi formada.
  • bytes_uncompressed (UInt64) — Tamanho descompactado da parte resultante, em bytes.
  • read_rows (UInt64) — Número de linhas lidas durante a mesclagem.
  • read_bytes (UInt64) — O número de bytes lidos durante a mesclagem.
  • peak_memory_usage (UInt64) — A quantidade máxima de RAM usada durante a operação de merge
  • deduplication_block_ids (Array(String)) — Um array de IDs de bloco usado na desduplicação ao inserir esta parte.
  • error (UInt16) — O código de erro da exceção gerada.
  • exception (String) — Mensagem de texto do erro ocorrido.
  • mutation_ids (Array(String)) — 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)) — Todos os eventos de perfil coletados durante esta operação.
  • projections_duration_ms (Map(LowCardinality(String), UInt64)) — 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

Última modificação em 1 de julho de 2026