> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.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/index)) — Identificador da partição (representação textual derivada da expressão da chave de particionamento).
* `name` ([String](/pt-BR/reference/data-types/index)) —
Nome da parte de dados. A estrutura do nome da parte pode ser usada para determinar muitos aspectos dos padrões de dados, de ingestão e de mesclagem. O formato do nome da parte é o seguinte:
```text theme={null}
____
```
* Definições:
* `partition_id` - identifica a chave de particionamento
* `minimum_block_number` - identifica o número mínimo do bloco na parte. O ClickHouse sempre faz a mesclagem de blocos contínuos
* `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 0 indica que esta é uma nova parte que ainda não passou por mesclagem. É importante lembrar que todas as partes no ClickHouse são sempre imutáveis
* `data_version` - valor opcional, incrementado quando uma parte é modificada por mutação (novamente, dados modificados por mutação sempre são gravados apenas em uma nova parte, já que as partes são imutáveis)
* `uuid` ([UUID](/pt-BR/reference/data-types/index)) — O UUID da parte de dados.
* `part_type` ([String](/pt-BR/reference/data-types/index)) — 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.
* `active` ([UInt8](/pt-BR/reference/data-types/index)) — Indicador que mostra se a parte de dados está ativa. Se uma parte de dados está ativa, ela é usada em uma tabela. Caso contrário, está prestes a ser excluída. Partes de dados inativas aparecem após operações de merge e mutação.
* `marks` ([UInt64](/pt-BR/reference/data-types/index)) — O número de marcas. Para obter o número aproximado de linhas em uma parte de dados, multiplique as marcas pela granularidade do índice (geralmente 8192) (esta dica não funciona para granularidade adaptativa).
* `rows` ([UInt64](/pt-BR/reference/data-types/index)) — O número de linhas.
* `files` ([UInt64](/pt-BR/reference/data-types/index)) — O número de arquivos na parte de dados.
* `bytes_on_disk` ([UInt64](/pt-BR/reference/data-types/index)) — Tamanho total, em bytes, de todos os arquivos da parte de dados.
* `data_compressed_bytes` ([UInt64](/pt-BR/reference/data-types/index)) — Tamanho total dos dados comprimidos na parte de dados. Arquivos auxiliares (por exemplo, arquivos com marcas) não estão incluídos.
* `data_uncompressed_bytes` ([UInt64](/pt-BR/reference/data-types/index)) — Tamanho total dos dados não comprimidos na parte de dados. Arquivos auxiliares (por exemplo, arquivos com marcas) não estão incluídos.
* `primary_key_size` ([UInt64](/pt-BR/reference/data-types/index)) — 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/index)) — O tamanho do arquivo com marcas.
* `secondary_indices_compressed_bytes` ([UInt64](/pt-BR/reference/data-types/index)) — Tamanho total dos dados comprimidos dos índices secundários na parte de dados. Arquivos auxiliares (por exemplo, arquivos com marcas) não estão incluídos.
* `secondary_indices_uncompressed_bytes` ([UInt64](/pt-BR/reference/data-types/index)) — Tamanho total dos dados não comprimidos dos índices secundários na parte de dados. Arquivos auxiliares (por exemplo, arquivos com marcas) não estão incluídos.
* `secondary_indices_marks_bytes` ([UInt64](/pt-BR/reference/data-types/index)) — O tamanho do arquivo com marcas dos índices secundários.
* `modification_time` ([DateTime](/pt-BR/reference/data-types/index)) — O momento em que o diretório com a parte de dados foi modificado. Isso geralmente corresponde ao momento de criação da parte de dados.
* `remove_time` ([DateTime](/pt-BR/reference/data-types/index)) — O momento em que a parte de dados se tornou inativa.
* `refcount` ([UInt32](/pt-BR/reference/data-types/index)) — 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 merges.
* `min_date` ([Date](/pt-BR/reference/data-types/index)) — O valor mínimo da chave de data na parte de dados.
* `max_date` ([Date](/pt-BR/reference/data-types/index)) — O valor máximo da chave de data na parte de dados.
* `min_time` ([DateTime](/pt-BR/reference/data-types/index)) — O valor mínimo da chave de data e hora na parte de dados.
* `max_time` ([DateTime](/pt-BR/reference/data-types/index)) — O valor máximo da chave de data e hora na parte de dados.
* `partition_id` ([String](/pt-BR/reference/data-types/index)) — O ID da partição.
* `min_block_number` ([Int64](/pt-BR/reference/data-types/index)) — O número mínimo de bloco das partes de dados que compõem a parte atual após o merge.
* `max_block_number` ([Int64](/pt-BR/reference/data-types/index)) — O número máximo de bloco das partes de dados que compõem a parte atual após o merge.
* `level` ([UInt32](/pt-BR/reference/data-types/index)) — A profundidade da árvore de merge. Zero significa que a parte atual foi criada por inserção, e não pelo merge de outras partes.
* `data_version` ([UInt64](/pt-BR/reference/data-types/index)) — Número usado para determinar quais mutações devem ser aplicadas à parte de dados (mutações com versão maior que data\_version).
* `primary_key_bytes_in_memory` ([UInt64](/pt-BR/reference/data-types/index)) — 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 estiver 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 por parte: um índice fica ou na parte (esta métrica) ou no `PrimaryIndexCache` compartilhado (a outra), dependendo de `primary_key_lazy_load` e `use_primary_key_cache`.
* `primary_key_bytes_in_memory_allocated` ([UInt64](/pt-BR/reference/data-types/index)) — 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 estiver carregada. Quando diferente de zero, é incluída em `jemalloc.mergetree_arena.active_bytes`. Veja a observação em `primary_key_bytes_in_memory` sobre a relação com `PrimaryIndexCacheBytes`.
* `index_granularity_bytes_in_memory` ([UInt64](/pt-BR/reference/data-types/index)) — Quantidade de memória (em bytes) usada pelos valores de granularidade do índice (será 0 no caso de 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/index)) — Quantidade de memória (em bytes) reservada para os valores de granularidade do índice (será 0 no caso de 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/index)) — Indicador de que existe um backup dos dados da partição. 1, o backup existe. 0, o backup não existe. Para mais detalhes, consulte FREEZE PARTITION.
* `database` ([String](/pt-BR/reference/data-types/index)) — Nome do banco de dados.
* `table` ([String](/pt-BR/reference/data-types/index)) — Nome da tabela.
* `engine` ([String](/pt-BR/reference/data-types/index)) — Nome do mecanismo de tabela sem parâmetros.
* `disk_name` ([String](/pt-BR/reference/data-types/index)) — Nome do disco que armazena a parte de dados.
* `path` ([String](/pt-BR/reference/data-types/index)) — Caminho absoluto para a pasta com os arquivos da parte de dados.
* `hash_of_all_files` ([String](/pt-BR/reference/data-types/index)) — sipHash128 dos arquivos comprimidos.
* `hash_of_uncompressed_files` ([String](/pt-BR/reference/data-types/index)) — sipHash128 dos arquivos não comprimidos (arquivos com marcas, arquivo de índice etc.).
* `uncompressed_hash_of_compressed_files` ([String](/pt-BR/reference/data-types/index)) — sipHash128 dos dados nos arquivos comprimidos como se não estivessem comprimidos.
* `delete_ttl_info_min` ([DateTime](/pt-BR/reference/data-types/index)) — Valor mínimo da chave de data e hora para a regra TTL DELETE.
* `delete_ttl_info_max` ([DateTime](/pt-BR/reference/data-types/index)) — 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/index)) — Array de expressões. Cada expressão define uma regra TTL MOVE.
* `move_ttl_info.min` ([Array(DateTime)](/pt-BR/reference/data-types/index)) — 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/index)) — 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/index)) — Nome do codec usado para comprimir esta parte de dados (quando não há um codec explícito para colunas).
* `recompression_ttl_info.expression` ([Array(String)](/pt-BR/reference/data-types/index)) — A expressão TTL.
* `recompression_ttl_info.min` ([Array(DateTime)](/pt-BR/reference/data-types/index)) — 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/index)) — O valor máximo da expressão TTL calculada nesta parte. Usado para determinar se temos todas as linhas com TTL expirado.
* `group_by_ttl_info.expression` ([Array(String)](/pt-BR/reference/data-types/index)) — A expressão TTL.
* `group_by_ttl_info.min` ([Array(DateTime)](/pt-BR/reference/data-types/index)) — O valor mínimo da expressão TTL calculada nesta parte. Usado para determinar se temos pelo menos uma linha com TTL expirado.
* `group_by_ttl_info.max` ([Array(DateTime)](/pt-BR/reference/data-types/index)) — O valor máximo da expressão TTL calculada nesta parte. Usado para determinar se temos todas as linhas com TTL expirado.
* `rows_where_ttl_info.expression` ([Array(String)](/pt-BR/reference/data-types/index)) — A expressão TTL.
* `rows_where_ttl_info.min` ([Array(DateTime)](/pt-BR/reference/data-types/index)) — O valor mínimo da expressão TTL calculada nesta parte. Usado para determinar se temos pelo menos uma linha com TTL expirado.
* `rows_where_ttl_info.max` ([Array(DateTime)](/pt-BR/reference/data-types/index)) — O valor máximo da expressão TTL calculada nesta parte. Usado para determinar se temos todas as linhas com TTL expirado.
* `projections` ([Array(String)](/pt-BR/reference/data-types/index)) — A lista de nomes de projeções calculados para esta parte.
* `visible` ([UInt8](/pt-BR/reference/data-types/index)) — Indicador que mostra se esta parte está visível para consultas SELECT.
* `creation_tid` ([Tuple(UInt64, UInt64, UUID)](/pt-BR/reference/data-types/index)) — ID da transação que criou/está tentando criar este objeto.
* `removal_tid_lock` ([UInt64](/pt-BR/reference/data-types/index)) — Hash de removal\_tid, usado para bloquear um objeto para remoção.
* `removal_tid` ([Tuple(UInt64, UInt64, UUID)](/pt-BR/reference/data-types/index)) — ID da transação que removeu/está tentando remover este objeto
* `creation_csn` ([UInt64](/pt-BR/reference/data-types/index)) — CSN da transação que criou este objeto
* `removal_csn` ([UInt64](/pt-BR/reference/data-types/index)) — CSN da transação que removeu este objeto
* `has_lightweight_delete` ([UInt8](/pt-BR/reference/data-types/index)) — Indicador que mostra se a parte possui uma máscara de exclusão leve.
* `last_removal_attempt_time` ([DateTime](/pt-BR/reference/data-types/index)) — A última vez em que o servidor tentou excluir esta parte.
* `removal_state` ([String](/pt-BR/reference/data-types/index)) — O estado atual do processo de remoção da parte.
## Exemplo
```sql theme={null}
SELECT * FROM system.parts LIMIT 1 FORMAT Vertical;
```
```text theme={null}
Linha 1:
──────
partition: tuple()
name: all_1_4_1_6
part_type: Wide
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)