> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-trino-dialect.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. > Tabela de sistema com informações sobre partes do MergeTree # system.parts
## Descrição
Contém informações sobre as partes das tabelas [MergeTree](/pt-BR/reference/engines/table-engines/mergetree-family/mergetree). Cada linha descreve uma parte de dados.
## Colunas
* `partition` ([String](/pt-BR/reference/data-types/string)) — Identificador da partição (representação textual derivada da expressão de chave de partição da tabela). * `name` ([String](/pt-BR/reference/data-types/string)) — Nome da parte de dados. A estrutura de nomenclatura da parte pode ser usada para determinar vários aspectos dos padrões de dados, de ingestão e de merge. O formato de nomenclatura da parte é o seguinte: ```text theme={null} ____ ``` * Definições: * `partition_id` - identifica a chave de partição * `minimum_block_number` - identifica o número mínimo do bloco na parte. O ClickHouse sempre mescla blocos contíguos * `maximum_block_number` - identifica o número máximo do bloco na parte * `level` - é incrementado em um a cada mesclagem adicional da parte. Um nível igual a 0 indica que esta é uma nova parte que ainda não foi mesclada. É importante lembrar que todas as partes no ClickHouse são sempre imutáveis * `data_version` - valor opcional, incrementado quando uma parte é alterada (novamente, os dados alterados são sempre gravados apenas em uma nova parte, pois as partes são imutáveis) * `uuid` ([UUID](/pt-BR/reference/data-types/uuid)) — O UUID da parte de dados. * `part_type` ([String](/pt-BR/reference/data-types/string)) — O formato de armazenamento da parte de dados. Valores possíveis: `Wide` — cada coluna é armazenada em um arquivo separado; `Compact` — todas as colunas são armazenadas em um único arquivo. O formato de armazenamento dos dados é controlado pelas configurações `min_bytes_for_wide_part` e `min_rows_for_wide_part` da tabela MergeTree. * `part_storage_type` ([String](/pt-BR/reference/data-types/string)) — O tipo de `DataPartStorage`. Valores possíveis: `Packed` — a maioria dos arquivos da parte é armazenada em um único arquivo compactado (as projeções e alguns arquivos de serviço, como `txn_version.txt`, são gravados separadamente); `Full` — cada arquivo é armazenado separadamente. * `active` ([UInt8](/pt-BR/reference/data-types/int-uint)) — Sinalizador que indica se a parte de dados está ativa. Se uma parte de dados estiver ativa, ela será usada em uma tabela. Caso contrário, está prestes a ser excluída. Partes de dados inativas surgem após operações de mesclagem e mutação. * `marks` ([UInt64](/pt-BR/reference/data-types/int-uint)) — O número de marcas. Para obter o número aproximado de linhas em uma parte de dados, multiplique o número de marcas pela granularidade do índice (geralmente 8192). Essa indicação não funciona com granularidade adaptativa. * `rows` ([UInt64](/pt-BR/reference/data-types/int-uint)) — O número de linhas. * `files` ([UInt64](/pt-BR/reference/data-types/int-uint)) — O número de arquivos na parte de dados. * `bytes_on_disk` ([UInt64](/pt-BR/reference/data-types/int-uint)) — O tamanho total, em bytes, de todos os arquivos da parte de dados. * `data_compressed_bytes` ([UInt64](/pt-BR/reference/data-types/int-uint)) — O tamanho total dos dados comprimidos na parte de dados. Arquivos auxiliares, como arquivos com marcas, não estão incluídos. * `data_uncompressed_bytes` ([UInt64](/pt-BR/reference/data-types/int-uint)) — O tamanho total dos dados não comprimidos na parte de dados. Arquivos auxiliares, como arquivos com marcas, não estão incluídos. * `primary_key_size` ([UInt64](/pt-BR/reference/data-types/int-uint)) — A quantidade de memória, em bytes, usada pelos valores da chave primária no arquivo primary.idx/cidx em disco. * `marks_bytes` ([UInt64](/pt-BR/reference/data-types/int-uint)) — O tamanho do arquivo com marcas. * `secondary_indices_compressed_bytes` ([UInt64](/pt-BR/reference/data-types/int-uint)) — O tamanho total dos dados comprimidos dos índices secundários na parte de dados. Arquivos auxiliares, como arquivos com marcas, não estão incluídos. * `secondary_indices_uncompressed_bytes` ([UInt64](/pt-BR/reference/data-types/int-uint)) — O tamanho total dos dados não comprimidos dos índices secundários na parte de dados. Arquivos auxiliares, como arquivos com marcas, não estão incluídos. * `secondary_indices_marks_bytes` ([UInt64](/pt-BR/reference/data-types/int-uint)) — O tamanho do arquivo com marcas dos índices secundários. * `modification_time` ([DateTime](/pt-BR/reference/data-types/datetime)) — O horário em que o diretório que contém a parte de dados foi modificado. Geralmente, corresponde ao horário de criação da parte de dados. * `remove_time` ([DateTime](/pt-BR/reference/data-types/datetime)) — O horário em que a parte de dados se tornou inativa. * `refcount` ([UInt32](/pt-BR/reference/data-types/int-uint)) — O número de locais em que a parte de dados é usada. Um valor maior que 2 indica que a parte de dados é usada em consultas ou mesclagens. * `min_date` ([Date](/pt-BR/reference/data-types/date)) — O valor mínimo da chave de data na parte de dados. * `max_date` ([Date](/pt-BR/reference/data-types/date)) — O valor máximo da chave de data na parte de dados. * `min_time` ([DateTime](/pt-BR/reference/data-types/datetime)) — O valor mínimo da chave de data e hora na parte de dados. * `max_time` ([DateTime](/pt-BR/reference/data-types/datetime)) — O valor máximo da chave de data e hora na parte de dados. * `partition_id` ([String](/pt-BR/reference/data-types/string)) — O ID da partição. * `min_block_number` ([Int64](/pt-BR/reference/data-types/int-uint)) — O número mínimo de partes de dados que compõem a parte atual após a mesclagem. * `max_block_number` ([Int64](/pt-BR/reference/data-types/int-uint)) — O número máximo de partes de dados que compõem a parte atual após a mesclagem. * `level` ([UInt32](/pt-BR/reference/data-types/int-uint)) — Profundidade da árvore de mesclagem. Zero significa que a parte atual foi criada por uma inserção, e não pela mesclagem de outras partes. * `data_version` ([UInt64](/pt-BR/reference/data-types/int-uint)) — Número usado para determinar quais mutações devem ser aplicadas à parte de dados (mutações com versão superior a data\_version). * `primary_key_bytes_in_memory` ([UInt64](/pt-BR/reference/data-types/int-uint)) — Quantidade de memória (em bytes) usada pelos valores da chave primária. Será 0 quando `primary_key_lazy_load` estiver habilitado e a chave não tiver sido carregada. Quando diferente de zero, os bytes ficam na própria parte e são contabilizados em `jemalloc.mergetree_arena.active_bytes`. Eles NUNCA são contabilizados em `PrimaryIndexCacheBytes` — são mutuamente exclusivos em cada parte: um índice fica na parte (esta métrica) ou no `PrimaryIndexCache` compartilhado (a outra métrica), dependendo de `primary_key_lazy_load` e `use_primary_key_cache`. * `primary_key_bytes_in_memory_allocated` ([UInt64](/pt-BR/reference/data-types/int-uint)) — Quantidade de memória (em bytes) reservada para os valores da chave primária. Será 0 quando `primary_key_lazy_load` estiver habilitado e a chave não tiver sido carregada. Quando diferente de zero, é incluída em `jemalloc.mergetree_arena.active_bytes`. Consulte a observação sobre `primary_key_bytes_in_memory` para entender a relação com `PrimaryIndexCacheBytes`. * `index_granularity_bytes_in_memory` ([UInt64](/pt-BR/reference/data-types/int-uint)) — Quantidade de memória (em bytes) usada pelos valores de granularidade do índice (será 0 se primary\_key\_lazy\_load=1 e use\_primary\_key\_cache=1). Quando diferente de zero, os bytes pertencem à parte e são contabilizados em `jemalloc.mergetree_arena.active_bytes`. * `index_granularity_bytes_in_memory_allocated` ([UInt64](/pt-BR/reference/data-types/int-uint)) — Quantidade de memória (em bytes) reservada para os valores de granularidade do índice (será 0 se primary\_key\_lazy\_load=1 e use\_primary\_key\_cache=1). Quando diferente de zero, é incluída em `jemalloc.mergetree_arena.active_bytes`. * `is_frozen` ([UInt8](/pt-BR/reference/data-types/int-uint)) — Flag que indica a existência de um backup dos dados da partição. 1 indica que o backup existe. 0 indica que o backup não existe. Para mais detalhes, consulte FREEZE PARTITION. * `database` ([String](/pt-BR/reference/data-types/string)) — Nome do banco de dados. * `table` ([String](/pt-BR/reference/data-types/string)) — Nome da tabela. * `engine` ([String](/pt-BR/reference/data-types/string)) — Nome do mecanismo de tabela sem parâmetros. * `disk_name` ([String](/pt-BR/reference/data-types/string)) — Nome do disco que armazena a parte de dados. * `path` ([String](/pt-BR/reference/data-types/string)) — Caminho absoluto para a pasta que contém os arquivos da parte de dados. * `hash_of_all_files` ([String](/pt-BR/reference/data-types/string)) — sipHash128 dos arquivos comprimidos. * `hash_of_uncompressed_files` ([String](/pt-BR/reference/data-types/string)) — sipHash128 dos arquivos descomprimidos (arquivos com marcas, arquivo de índice etc.). * `uncompressed_hash_of_compressed_files` ([String](/pt-BR/reference/data-types/string)) — sipHash128 dos dados nos arquivos comprimidos como se estivessem descomprimidos. * `delete_ttl_info_min` ([DateTime](/pt-BR/reference/data-types/datetime)) — Valor mínimo da chave de data e hora para a regra TTL DELETE. * `delete_ttl_info_max` ([DateTime](/pt-BR/reference/data-types/datetime)) — Valor máximo da chave de data e hora para a regra TTL DELETE. * `move_ttl_info.expression` ([Array(String)](/pt-BR/reference/data-types/array)) — Array de expressões. Cada expressão define uma regra TTL MOVE. * `move_ttl_info.min` ([Array(DateTime)](/pt-BR/reference/data-types/array)) — Array de valores de data e hora. Cada elemento descreve o valor mínimo da chave para uma regra TTL MOVE. * `move_ttl_info.max` ([Array(DateTime)](/pt-BR/reference/data-types/array)) — Array de valores de data e hora. Cada elemento descreve o valor máximo da chave para uma regra TTL MOVE. * `default_compression_codec` ([String](/pt-BR/reference/data-types/string)) — O nome do codec usado para compactar esta parte de dados quando uma coluna não tem um codec explícito ou usa `CODEC(Default)`. Com `allow_experimental_adaptive_codec_selection`, blocos individuais dessas colunas podem usar outros codecs; consulte [`mergeTreeCodecBlockCounts`](/pt-BR/reference/functions/table-functions/mergeTreeCodecBlockCounts). * `recompression_ttl_info.expression` ([Array(String)](/pt-BR/reference/data-types/array)) — A expressão TTL. * `recompression_ttl_info.min` ([Array(DateTime)](/pt-BR/reference/data-types/array)) — O valor mínimo da expressão TTL calculada nesta parte. Usado para determinar se há pelo menos uma linha com TTL expirado. * `recompression_ttl_info.max` ([Array(DateTime)](/pt-BR/reference/data-types/array)) — O valor máximo da expressão TTL calculada nesta parte. Usado para determinar se todas as linhas têm TTL expirado. * `group_by_ttl_info.expression` ([Array(String)](/pt-BR/reference/data-types/array)) — A expressão TTL. * `group_by_ttl_info.min` ([Array(DateTime)](/pt-BR/reference/data-types/array)) — O valor mínimo da expressão TTL calculada nesta parte. Usado para determinar se há pelo menos uma linha com TTL expirado. * `group_by_ttl_info.max` ([Array(DateTime)](/pt-BR/reference/data-types/array)) — O valor máximo da expressão TTL calculada nesta parte. Usado para determinar se todas as linhas têm TTL expirado. * `rows_where_ttl_info.expression` ([Array(String)](/pt-BR/reference/data-types/array)) — A expressão TTL. * `rows_where_ttl_info.min` ([Array(DateTime)](/pt-BR/reference/data-types/array)) — O valor mínimo da expressão TTL calculada nesta parte. Usado para determinar se há pelo menos uma linha com TTL expirado. * `rows_where_ttl_info.max` ([Array(DateTime)](/pt-BR/reference/data-types/array)) — O valor máximo da expressão TTL calculada nesta parte. Usado para determinar se todas as linhas têm TTL expirado. * `projections` ([Array(String)](/pt-BR/reference/data-types/array)) — A lista de nomes das projeções calculadas para esta parte. * `visible` ([UInt8](/pt-BR/reference/data-types/int-uint)) — Sinalizador que indica se esta parte está visível para consultas SELECT. * `creation_tid` ([Tuple(UInt64, UInt64, UUID)](/pt-BR/reference/data-types/tuple)) — ID da transação que criou/está tentando criar este objeto. * `removal_tid_lock` ([UInt64](/pt-BR/reference/data-types/int-uint)) — Hash de removal\_tid, usado para bloquear um objeto para remoção. * `removal_tid` ([Tuple(UInt64, UInt64, UUID)](/pt-BR/reference/data-types/tuple)) — ID da transação que removeu/está tentando remover este objeto * `creation_csn` ([UInt64](/pt-BR/reference/data-types/int-uint)) — CSN da transação que criou este objeto * `removal_csn` ([UInt64](/pt-BR/reference/data-types/int-uint)) — CSN da transação que removeu este objeto * `has_lightweight_delete` ([UInt8](/pt-BR/reference/data-types/int-uint)) — Sinalizador que indica se a parte tem uma máscara de exclusão leve. * `last_removal_attempt_time` ([DateTime](/pt-BR/reference/data-types/datetime)) — A última vez que o servidor tentou excluir esta parte. * `removal_state` ([String](/pt-BR/reference/data-types/string)) — O estado atual do processo de remoção da parte. **Aliases:** * `bytes` — Alias para `bytes_on_disk`. * `marks_size` — Alias para `marks_bytes`. * `part_name` — Alias para `name`.
## Exemplo
```sql theme={null} SELECT * FROM system.parts LIMIT 1 FORMAT Vertical; ``` ```text theme={null} Row 1: ────── partition: tuple() name: all_1_4_1_6 part_type: Wide part_storage_type: Full active: 1 marks: 2 rows: 6 bytes_on_disk: 310 data_compressed_bytes: 157 data_uncompressed_bytes: 91 secondary_indices_compressed_bytes: 58 secondary_indices_uncompressed_bytes: 6 secondary_indices_marks_bytes: 48 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: all 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: months engine: MergeTree disk_name: default path: /var/lib/clickhouse/data/default/months/all_1_4_1_6/ 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: [] ```
## Veja também
* [Família MergeTree](/pt-BR/reference/engines/table-engines/mergetree-family/mergetree) * [TTL para colunas e tabelas](/pt-BR/reference/engines/table-engines/mergetree-family/mergetree#table_engine-mergetree-ttl)