Skip to main content

​
Description

Contient des informations sur les parts de données des tables MergeTree. Chaque ligne décrit une part de données.

​
Colonnes

  • partition (String) — Identifiant de partition (représentation textuelle dérivée de l’expression de clé de partition de la table).
  • name (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 :
    • 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) — L’UUID de la partie de données.
  • part_type (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) — 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) — 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) — 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) — Le nombre de lignes.
  • files (UInt64) — Le nombre de fichiers dans la partie de données.
  • bytes_on_disk (UInt64) — Taille totale, en octets, de tous les fichiers de la partie de données.
  • data_compressed_bytes (UInt64) — 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) — 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) — 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) — La taille du fichier contenant les marques.
  • secondary_indices_compressed_bytes (UInt64) — 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) — 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) — La taille du fichier contenant les marques des index secondaires.
  • modification_time (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) — L’heure à laquelle la partie de données est devenue inactive.
  • refcount (UInt32) — 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) — La valeur minimale de la clé de date dans la partie de données.
  • max_date (Date) — La valeur maximale de la clé de date dans la partie de données.
  • min_time (DateTime) — La valeur minimale de la clé de date et d’heure dans la partie de données.
  • max_time (DateTime) — La valeur maximale de la clé de date et d’heure dans la partie de données.
  • partition_id (String) — L’identifiant de la partition.
  • min_block_number (Int64) — Le numéro minimal des parties de données qui composent la partie actuelle après fusion.
  • max_block_number (Int64) — Le numéro maximal des parties de données qui composent la partie actuelle après fusion.
  • level (UInt32) — 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) — 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) — 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) — 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) — 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) — 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) — 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) — Nom de la base de données.
  • table (String) — Nom de la table.
  • engine (String) — Nom du moteur de table sans paramètres.
  • disk_name (String) — Nom du disque qui stocke la part de données.
  • path (String) — Chemin absolu vers le dossier contenant les fichiers de la part de données.
  • hash_of_all_files (String) — sipHash128 des fichiers compressés.
  • hash_of_uncompressed_files (String) — sipHash128 des fichiers non compressés (fichiers de marques, fichier d’index, etc.).
  • uncompressed_hash_of_compressed_files (String) — sipHash128 des données contenues dans les fichiers compressés, comme si elles n’étaient pas compressées.
  • delete_ttl_info_min (DateTime) — Valeur minimale de la clé de date et d’heure pour la règle TTL DELETE.
  • delete_ttl_info_max (DateTime) — Valeur maximale de la clé de date et d’heure pour la règle TTL DELETE.
  • move_ttl_info.expression (Array(String)) — Tableau d’expressions. Chaque expression définit une règle TTL MOVE.
  • move_ttl_info.min (Array(DateTime)) — 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)) — 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) — 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.
  • recompression_ttl_info.expression (Array(String)) — Expression TTL.
  • recompression_ttl_info.min (Array(DateTime)) — 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)) — 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)) — Expression TTL.
  • group_by_ttl_info.min (Array(DateTime)) — 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)) — 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)) — Expression TTL.
  • rows_where_ttl_info.min (Array(DateTime)) — 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)) — 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)) — Liste des noms des projections calculées pour cette partie.
  • visible (UInt8) — Indicateur précisant si cette partie est visible pour les requêtes SELECT.
  • creation_tid (Tuple(UInt64, UInt64, UUID)) — ID de la transaction qui a créé ou tente de créer cet objet.
  • removal_tid_lock (UInt64) — Hash de removal_tid, utilisé pour verrouiller un objet en vue de sa suppression.
  • removal_tid (Tuple(UInt64, UInt64, UUID)) — ID de la transaction qui a supprimé ou tente de supprimer cet objet
  • creation_csn (UInt64) — CSN de la transaction qui a créé cet objet
  • removal_csn (UInt64) — CSN de la transaction qui a supprimé cet objet
  • has_lightweight_delete (UInt8) — Indicateur précisant si la partie possède un masque de suppression légère.
  • last_removal_attempt_time (DateTime) — Dernière tentative du serveur de supprimer cette partie.
  • removal_state (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

​
Voir aussi

Dernière modification le 14 août 2026