> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-revert-104359-revert-104251-parquet-single.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Table système contenant des informations sur les parts des tables MergeTree
# system.parts
## Description
Contient des informations sur les parts de données des tables [MergeTree](/fr/reference/engines/table-engines/mergetree-family/mergetree).
Chaque ligne décrit une part de données.
## Colonnes
* `partition` ([String](/fr/reference/data-types/string)) — Identifiant de partition (représentation textuelle dérivée de l’expression de clé de partition de la table).
* `name` ([String](/fr/reference/data-types/string)) — Nom de la partie de données. La structure de son nom permet de déterminer de nombreux aspects des données ainsi que des schémas d’ingestion et de fusion. Le format de nommage de la partie est le suivant :
```text theme={null}
____
```
* Définitions :
* `partition_id` - identifie la clé de partitionnement
* `minimum_block_number` - identifie le numéro de bloc minimal dans la part. ClickHouse fusionne toujours les blocs contigus
* `maximum_block_number` - identifie le numéro de bloc maximal dans la part
* `level` - incrémenté de un à chaque fusion supplémentaire de la part. Un niveau de 0 indique qu'il s'agit d'une nouvelle part qui n'a pas encore été fusionnée. Il est important de se rappeler que toutes les parts de ClickHouse sont immuables
* `data_version` - valeur facultative, incrémentée lorsqu'une part est mutée (là encore, les données mutées sont toujours écrites dans une nouvelle part, car les parts sont immuables)
* `uuid` ([UUID](/fr/reference/data-types/uuid)) — L’UUID de la partie de données.
* `part_type` ([String](/fr/reference/data-types/string)) — Le format de stockage de la partie de données. Valeurs possibles : `Wide` — chaque colonne est stockée dans un fichier distinct ; `Compact` — toutes les colonnes sont stockées dans un seul fichier. Le format de stockage des données est contrôlé par les paramètres `min_bytes_for_wide_part` et `min_rows_for_wide_part` de la table MergeTree.
* `part_storage_type` ([String](/fr/reference/data-types/string)) — Le type de `DataPartStorage`. Valeurs possibles : `Packed` — la plupart des fichiers de la partie sont stockés dans une seule archive (les projections et quelques fichiers de service, tels que `txn_version.txt`, sont écrits séparément) ; `Full` — chaque fichier est stocké séparément.
* `active` ([UInt8](/fr/reference/data-types/int-uint)) — Indicateur signalant si la partie de données est active. Si une partie de données est active, elle est utilisée dans une table. Sinon, elle est sur le point d’être supprimée. Les parties de données inactives apparaissent après des opérations de fusion et de mutation.
* `marks` ([UInt64](/fr/reference/data-types/int-uint)) — Le nombre de marques. Pour obtenir le nombre approximatif de lignes d’une partie de données, multipliez le nombre de marques par la granularité d’index (généralement 8192). Cette approximation ne fonctionne pas avec la granularité adaptative.
* `rows` ([UInt64](/fr/reference/data-types/int-uint)) — Le nombre de lignes.
* `files` ([UInt64](/fr/reference/data-types/int-uint)) — Le nombre de fichiers dans la partie de données.
* `bytes_on_disk` ([UInt64](/fr/reference/data-types/int-uint)) — Taille totale, en octets, de tous les fichiers de la partie de données.
* `data_compressed_bytes` ([UInt64](/fr/reference/data-types/int-uint)) — Taille totale des données compressées dans la partie de données. Les fichiers auxiliaires, tels que les fichiers contenant des marques, ne sont pas inclus.
* `data_uncompressed_bytes` ([UInt64](/fr/reference/data-types/int-uint)) — Taille totale des données non compressées dans la partie de données. Les fichiers auxiliaires, tels que les fichiers contenant des marques, ne sont pas inclus.
* `primary_key_size` ([UInt64](/fr/reference/data-types/int-uint)) — Quantité de mémoire, en octets, utilisée par les valeurs de la clé primaire dans le fichier primary.idx/cidx sur le disque.
* `marks_bytes` ([UInt64](/fr/reference/data-types/int-uint)) — La taille du fichier contenant les marques.
* `secondary_indices_compressed_bytes` ([UInt64](/fr/reference/data-types/int-uint)) — Taille totale des données compressées des index secondaires dans la partie de données. Les fichiers auxiliaires, tels que les fichiers contenant des marques, ne sont pas inclus.
* `secondary_indices_uncompressed_bytes` ([UInt64](/fr/reference/data-types/int-uint)) — Taille totale des données non compressées des index secondaires dans la partie de données. Les fichiers auxiliaires, tels que les fichiers contenant des marques, ne sont pas inclus.
* `secondary_indices_marks_bytes` ([UInt64](/fr/reference/data-types/int-uint)) — La taille du fichier contenant les marques des index secondaires.
* `modification_time` ([DateTime](/fr/reference/data-types/datetime)) — L’heure à laquelle le répertoire contenant la partie de données a été modifié. Cela correspond généralement à l’heure de création de la partie de données.
* `remove_time` ([DateTime](/fr/reference/data-types/datetime)) — L’heure à laquelle la partie de données est devenue inactive.
* `refcount` ([UInt32](/fr/reference/data-types/int-uint)) — Le nombre de références à la partie de données. Une valeur supérieure à 2 indique que la partie de données est utilisée dans des requêtes ou des fusions.
* `min_date` ([Date](/fr/reference/data-types/date)) — La valeur minimale de la clé de date dans la partie de données.
* `max_date` ([Date](/fr/reference/data-types/date)) — La valeur maximale de la clé de date dans la partie de données.
* `min_time` ([DateTime](/fr/reference/data-types/datetime)) — La valeur minimale de la clé de date et d’heure dans la partie de données.
* `max_time` ([DateTime](/fr/reference/data-types/datetime)) — La valeur maximale de la clé de date et d’heure dans la partie de données.
* `partition_id` ([String](/fr/reference/data-types/string)) — L’identifiant de la partition.
* `min_block_number` ([Int64](/fr/reference/data-types/int-uint)) — Le numéro minimal des parties de données qui composent la partie actuelle après fusion.
* `max_block_number` ([Int64](/fr/reference/data-types/int-uint)) — Le numéro maximal des parties de données qui composent la partie actuelle après fusion.
* `level` ([UInt32](/fr/reference/data-types/int-uint)) — Profondeur de l’arbre de fusion. Zéro signifie que la part actuelle a été créée par insertion plutôt que par fusion d’autres parts.
* `data_version` ([UInt64](/fr/reference/data-types/int-uint)) — Nombre utilisé pour déterminer les mutations à appliquer à la part de données (mutations dont la version est supérieure à data\_version).
* `primary_key_bytes_in_memory` ([UInt64](/fr/reference/data-types/int-uint)) — Quantité de mémoire (en octets) utilisée par les valeurs de clé primaire. Égale à 0 lorsque `primary_key_lazy_load` est activé et que la clé n’est pas chargée. Lorsqu’elle est non nulle, les octets sont stockés dans la part elle-même et comptabilisés dans `jemalloc.mergetree_arena.active_bytes`. Ils ne sont JAMAIS comptabilisés dans `PrimaryIndexCacheBytes` : pour chaque part, ces deux emplacements s’excluent mutuellement. Un index se trouve soit dans la part (cette métrique), soit dans le `PrimaryIndexCache` partagé (l’autre métrique), selon `primary_key_lazy_load` et `use_primary_key_cache`.
* `primary_key_bytes_in_memory_allocated` ([UInt64](/fr/reference/data-types/int-uint)) — Quantité de mémoire (en octets) réservée aux valeurs de clé primaire. Égale à 0 lorsque `primary_key_lazy_load` est activé et que la clé n’est pas chargée. Lorsqu’elle est non nulle, elle est incluse dans `jemalloc.mergetree_arena.active_bytes`. Consultez la note sur `primary_key_bytes_in_memory` pour connaître le lien avec `PrimaryIndexCacheBytes`.
* `index_granularity_bytes_in_memory` ([UInt64](/fr/reference/data-types/int-uint)) — Quantité de mémoire (en octets) utilisée par les valeurs de granularité d’index (égale à 0 lorsque primary\_key\_lazy\_load=1 et use\_primary\_key\_cache=1). Lorsqu’ils sont non nuls, les octets sont associés à la part et comptabilisés dans `jemalloc.mergetree_arena.active_bytes`.
* `index_granularity_bytes_in_memory_allocated` ([UInt64](/fr/reference/data-types/int-uint)) — Quantité de mémoire (en octets) réservée aux valeurs de granularité d’index (égale à 0 lorsque primary\_key\_lazy\_load=1 et use\_primary\_key\_cache=1). Lorsqu’elle est non nulle, elle est incluse dans `jemalloc.mergetree_arena.active_bytes`.
* `is_frozen` ([UInt8](/fr/reference/data-types/int-uint)) — Indicateur signalant l’existence d’une sauvegarde des données d’une partition. 1 : la sauvegarde existe. 0 : la sauvegarde n’existe pas. Pour plus de détails, consultez FREEZE PARTITION.
* `database` ([String](/fr/reference/data-types/string)) — Nom de la base de données.
* `table` ([String](/fr/reference/data-types/string)) — Nom de la table.
* `engine` ([String](/fr/reference/data-types/string)) — Nom du moteur de table sans paramètres.
* `disk_name` ([String](/fr/reference/data-types/string)) — Nom du disque qui stocke la part de données.
* `path` ([String](/fr/reference/data-types/string)) — Chemin absolu vers le dossier contenant les fichiers de la part de données.
* `hash_of_all_files` ([String](/fr/reference/data-types/string)) — sipHash128 des fichiers compressés.
* `hash_of_uncompressed_files` ([String](/fr/reference/data-types/string)) — sipHash128 des fichiers non compressés (fichiers de marques, fichier d’index, etc.).
* `uncompressed_hash_of_compressed_files` ([String](/fr/reference/data-types/string)) — sipHash128 des données contenues dans les fichiers compressés, comme si elles n’étaient pas compressées.
* `delete_ttl_info_min` ([DateTime](/fr/reference/data-types/datetime)) — Valeur minimale de la clé de date et d’heure pour la règle TTL DELETE.
* `delete_ttl_info_max` ([DateTime](/fr/reference/data-types/datetime)) — Valeur maximale de la clé de date et d’heure pour la règle TTL DELETE.
* `move_ttl_info.expression` ([Array(String)](/fr/reference/data-types/array)) — Tableau d’expressions. Chaque expression définit une règle TTL MOVE.
* `move_ttl_info.min` ([Array(DateTime)](/fr/reference/data-types/array)) — Tableau de valeurs de date et d’heure. Chaque élément décrit la valeur minimale de la clé pour une règle TTL MOVE.
* `move_ttl_info.max` ([Array(DateTime)](/fr/reference/data-types/array)) — Tableau de valeurs de date et d’heure. Chaque élément décrit la valeur maximale de la clé pour une règle TTL MOVE.
* `default_compression_codec` ([String](/fr/reference/data-types/string)) — Nom du codec utilisé pour compresser cette partie de données lorsqu'une colonne ne possède pas de codec explicite ou utilise `CODEC(Default)`. Avec `allow_experimental_adaptive_codec_selection`, des blocs individuels de ces colonnes peuvent utiliser d'autres codecs ; voir [`mergeTreeCodecBlockCounts`](/fr/reference/functions/table-functions/mergeTreeCodecBlockCounts).
* `recompression_ttl_info.expression` ([Array(String)](/fr/reference/data-types/array)) — Expression TTL.
* `recompression_ttl_info.min` ([Array(DateTime)](/fr/reference/data-types/array)) — Valeur minimale de l'expression TTL calculée dans cette partie. Permet de déterminer si au moins une ligne a un TTL expiré.
* `recompression_ttl_info.max` ([Array(DateTime)](/fr/reference/data-types/array)) — Valeur maximale de l'expression TTL calculée dans cette partie. Permet de déterminer si toutes les lignes ont un TTL expiré.
* `group_by_ttl_info.expression` ([Array(String)](/fr/reference/data-types/array)) — Expression TTL.
* `group_by_ttl_info.min` ([Array(DateTime)](/fr/reference/data-types/array)) — Valeur minimale de l'expression TTL calculée dans cette partie. Permet de déterminer si au moins une ligne a un TTL expiré.
* `group_by_ttl_info.max` ([Array(DateTime)](/fr/reference/data-types/array)) — Valeur maximale de l'expression TTL calculée dans cette partie. Permet de déterminer si toutes les lignes ont un TTL expiré.
* `rows_where_ttl_info.expression` ([Array(String)](/fr/reference/data-types/array)) — Expression TTL.
* `rows_where_ttl_info.min` ([Array(DateTime)](/fr/reference/data-types/array)) — Valeur minimale de l'expression TTL calculée dans cette partie. Permet de déterminer si au moins une ligne a un TTL expiré.
* `rows_where_ttl_info.max` ([Array(DateTime)](/fr/reference/data-types/array)) — Valeur maximale de l'expression TTL calculée dans cette partie. Permet de déterminer si toutes les lignes ont un TTL expiré.
* `projections` ([Array(String)](/fr/reference/data-types/array)) — Liste des noms des projections calculées pour cette partie.
* `visible` ([UInt8](/fr/reference/data-types/int-uint)) — Indicateur précisant si cette partie est visible pour les requêtes SELECT.
* `creation_tid` ([Tuple(UInt64, UInt64, UUID)](/fr/reference/data-types/tuple)) — ID de la transaction qui a créé ou tente de créer cet objet.
* `removal_tid_lock` ([UInt64](/fr/reference/data-types/int-uint)) — Hash de removal\_tid, utilisé pour verrouiller un objet en vue de sa suppression.
* `removal_tid` ([Tuple(UInt64, UInt64, UUID)](/fr/reference/data-types/tuple)) — ID de la transaction qui a supprimé ou tente de supprimer cet objet
* `creation_csn` ([UInt64](/fr/reference/data-types/int-uint)) — CSN de la transaction qui a créé cet objet
* `removal_csn` ([UInt64](/fr/reference/data-types/int-uint)) — CSN de la transaction qui a supprimé cet objet
* `has_lightweight_delete` ([UInt8](/fr/reference/data-types/int-uint)) — Indicateur précisant si la partie possède un masque de suppression légère.
* `last_removal_attempt_time` ([DateTime](/fr/reference/data-types/datetime)) — Dernière tentative du serveur de supprimer cette partie.
* `removal_state` ([String](/fr/reference/data-types/string)) — État actuel du processus de suppression de la partie.
**Alias :**
* `bytes` — alias de `bytes_on_disk`.
* `marks_size` — alias de `marks_bytes`.
* `part_name` — alias de `name`.
## Exemple
```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: []
```
## Voir aussi
* [Famille de moteurs MergeTree](/fr/reference/engines/table-engines/mergetree-family/mergetree)
* [TTL pour les colonnes et les tables](/fr/reference/engines/table-engines/mergetree-family/mergetree#table_engine-mergetree-ttl)