Saltar al contenido principal

​
Descripción

Contiene información sobre las partes de datos de las tablas MergeTree. Cada fila describe una parte de datos.

​
Columnas

  • partition (String) — Identificador de la partición (representación textual derivada de la expresión de la clave de partición de la tabla).
  • name (String) — Nombre de la parte de datos. La estructura de nomenclatura de la parte puede usarse para determinar muchos aspectos de los datos, así como los patrones de ingesta y fusión. El formato de nomenclatura de la parte es el siguiente:
<partition_id>_<minimum_block_number>_<maximum_block_number>_<level>_<data_version>
  • Definiciones:
    • partition_id - identifica la clave de partición
    • minimum_block_number - identifica el número de bloque mínimo de la parte. ClickHouse siempre fusiona bloques continuos
    • maximum_block_number - identifica el número de bloque máximo de la parte
    • level - se incrementa en uno con cada fusión adicional de la parte. Un nivel de 0 indica que esta es una parte nueva que no se ha fusionado. Es importante recordar que todas las partes de ClickHouse son siempre inmutables
    • data_version - valor opcional que se incrementa cuando una parte se modifica (de nuevo, los datos modificados siempre se escriben únicamente en una parte nueva, ya que las partes son inmutables)
  • uuid (UUID) — UUID de la parte de datos.
  • part_type (String) — El formato de almacenamiento de la parte de datos. Valores posibles: Wide — cada columna se almacena en un archivo independiente; Compact — todas las columnas se almacenan en un solo archivo. El formato de almacenamiento de los datos está controlado por los ajustes min_bytes_for_wide_part y min_rows_for_wide_part de la tabla MergeTree.
  • active (UInt8) — Indicador que indica si la parte de datos está activa. Si una parte de datos está activa, se usa en una tabla. De lo contrario, está a punto de eliminarse. Las partes de datos inactivas aparecen después de las operaciones de fusión y mutación.
  • marks (UInt64) — El número de marcas. Para obtener el número aproximado de filas en una parte de datos, multiplique las marcas por la granularidad del índice (normalmente, 8192) (esta aproximación no funciona con granularidad adaptativa).
  • rows (UInt64) — El número de filas.
  • files (UInt64) — El número de archivos de la parte de datos.
  • bytes_on_disk (UInt64) — Tamaño total en bytes de todos los archivos de las partes de datos.
  • data_compressed_bytes (UInt64) — Tamaño total de los datos comprimidos en la parte de datos. No se incluyen los archivos auxiliares (por ejemplo, los archivos con marcas).
  • data_uncompressed_bytes (UInt64) — Tamaño total de los datos sin comprimir en la parte de datos. No se incluye ninguno de los archivos auxiliares (por ejemplo, los archivos de marcas).
  • primary_key_size (UInt64) — La cantidad de memoria (en bytes) que usan los valores de la clave primaria en el archivo primary.idx/cidx del disco.
  • marks_bytes (UInt64) — El tamaño del archivo de marcas.
  • secondary_indices_compressed_bytes (UInt64) — Tamaño total de los datos comprimidos de los índices secundarios en la parte de datos. No se incluye ningún archivo auxiliar (por ejemplo, los archivos con marcas).
  • secondary_indices_uncompressed_bytes (UInt64) — Tamaño total de los datos sin comprimir de los índices secundarios en la parte de datos. No se incluye ninguno de los archivos auxiliares (por ejemplo, los archivos de marcas).
  • secondary_indices_marks_bytes (UInt64) — El tamaño del archivo de marcas de los índices secundarios.
  • modification_time (DateTime) — La fecha y hora en que se modificó el directorio que contiene la parte de datos. Esto suele corresponder al momento de creación de la parte de datos.
  • remove_time (DateTime) — La hora a la que la parte de datos pasó a estar inactiva.
  • refcount (UInt32) — El número de lugares en los que se utiliza la parte de datos. Un valor superior a 2 indica que la parte de datos se utiliza en consultas o fusiones.
  • min_date (Date) — El valor mínimo de la clave de fecha de la parte de datos.
  • max_date (Date) — El valor máximo de la clave de fecha del data part.
  • min_time (DateTime) — El valor mínimo de la clave de fecha y hora de la parte de datos.
  • max_time (DateTime) — El valor máximo de la clave de fecha y hora de la parte de datos.
  • partition_id (String) — identificador de la partición.
  • min_block_number (Int64) — El número mínimo de partes de datos que componen la parte actual tras la fusión.
  • max_block_number (Int64) — El número máximo de partes de datos que conforman la parte actual tras la fusión.
  • level (UInt32) — Profundidad del árbol de fusiones. Cero significa que la parte actual se creó mediante una operación insert, en lugar de por la fusión de otras partes.
  • data_version (UInt64) — Número utilizado para determinar qué mutaciones deben aplicarse a la parte de datos (las mutaciones con una versión superior a data_version).
  • primary_key_bytes_in_memory (UInt64) — La cantidad de memoria (en bytes) utilizada por los valores de la clave primaria. Será 0 cuando primary_key_lazy_load esté habilitado y la clave no se haya cargado. Cuando es distinto de cero, los bytes residen en la propia parte y se contabilizan dentro de jemalloc.mergetree_arena.active_bytes. NUNCA se cuentan en PrimaryIndexCacheBytes — son mutuamente excluyentes por parte: un índice reside o bien en la parte (esta métrica) o bien en el PrimaryIndexCache compartido (la otra), según primary_key_lazy_load y use_primary_key_cache.
  • primary_key_bytes_in_memory_allocated (UInt64) — La cantidad de memoria (en bytes) reservada para los valores de la clave primaria. Será 0 cuando primary_key_lazy_load esté habilitado y la clave no esté cargada. Cuando no sea cero, se incluye en jemalloc.mergetree_arena.active_bytes. Consulte la nota sobre primary_key_bytes_in_memory para ver la relación con PrimaryIndexCacheBytes.
  • index_granularity_bytes_in_memory (UInt64) — La cantidad de memoria (en bytes) utilizada por los valores de granularidad del índice (será 0 en el caso de primary&#95;key&#95;lazy&#95;load=1 y use&#95;primary&#95;key&#95;cache=1). Cuando no es cero, la propiedad de esos bytes se comparte parcialmente y se contabilizan dentro de jemalloc.mergetree_arena.active_bytes.
  • index_granularity_bytes_in_memory_allocated (UInt64) — La cantidad de memoria (en bytes) reservada para los valores de granularidad del índice (será 0 en el caso de primary_key_lazy_load=1 y use_primary_key_cache=1). Cuando es distinto de cero, se incluye en jemalloc.mergetree_arena.active_bytes.
  • is_frozen (UInt8) — Indicador que muestra si existe una copia de seguridad de los datos de una partición. 1, la copia de seguridad existe. 0, la copia de seguridad no existe. Para obtener más información, consulte FREEZE PARTITION.
  • database (String) — Nombre de la base de datos.
  • table (String) — Nombre de la tabla.
  • engine (String) — Nombre del motor de la tabla sin parámetros.
  • disk_name (String) — Nombre del disco que almacena la parte de datos.
  • path (String) — Ruta absoluta de la carpeta que contiene los archivos de la parte de datos.
  • hash_of_all_files (String) — sipHash128 de los archivos comprimidos.
  • hash_of_uncompressed_files (String) — sipHash128 de los archivos sin comprimir (archivos con marcas, archivo de índice, etc.).
  • uncompressed_hash_of_compressed_files (String) — sipHash128 de los datos contenidos en los archivos comprimidos, como si no estuvieran comprimidos.
  • delete_ttl_info_min (DateTime) — El valor mínimo de la clave de fecha y hora de la regla TTL DELETE.
  • delete_ttl_info_max (DateTime) — El valor máximo de la clave de fecha y hora de la regla TTL DELETE.
  • move_ttl_info.expression (Array(String)) — Array de expresiones. Cada expresión define una regla de TTL MOVE.
  • move_ttl_info.min (Array(DateTime)) — Array de valores de fecha y hora. Cada elemento describe el valor mínimo de la clave para una regla TTL MOVE.
  • move_ttl_info.max (Array(DateTime)) — Array de valores de fecha y hora. Cada elemento describe el valor máximo de la clave de una regla TTL MOVE.
  • default_compression_codec (String) — El nombre del códec utilizado para comprimir esta parte de datos (en caso de que no haya un códec explícito para las columnas).
  • recompression_ttl_info.expression (Array(String)) — La expresión TTL.
  • recompression_ttl_info.min (Array(DateTime)) — El valor mínimo de la expresión TTL calculada dentro de esta parte. Se utiliza para saber si hay al menos una fila con el TTL vencido.
  • recompression_ttl_info.max (Array(DateTime)) — El valor máximo de la expresión TTL calculada dentro de esta parte. Se utiliza para determinar si todas las filas tienen el TTL vencido.
  • group_by_ttl_info.expression (Array(String)) — La expresión de TTL.
  • group_by_ttl_info.min (Array(DateTime)) — El valor mínimo de la expresión TTL calculada dentro de esta parte. Se utiliza para determinar si hay al menos una fila con el TTL vencido.
  • group_by_ttl_info.max (Array(DateTime)) — El valor máximo de la expresión TTL calculada dentro de esta parte. Se utiliza para determinar si tenemos todas las filas con el TTL vencido.
  • rows_where_ttl_info.expression (Array(String)) — La expresión TTL.
  • rows_where_ttl_info.min (Array(DateTime)) — El valor mínimo de la expresión TTL calculada en esta parte. Se utiliza para determinar si hay al menos una fila con TTL caducado.
  • rows_where_ttl_info.max (Array(DateTime)) — El valor máximo de la expresión TTL calculada dentro de esta parte. Se utiliza para determinar si tenemos todas las filas con el TTL vencido.
  • projections (Array(String)) — La lista de nombres de las proyecciones calculados para esta parte.
  • visible (UInt8) — Indicador que señala si esta parte es visible para las consultas SELECT.
  • creation_tid (Tuple(UInt64, UInt64, UUID)) — ID de la transacción que creó o está intentando crear este objeto.
  • removal_tid_lock (UInt64) — Hash de removal_tid, que se utiliza para bloquear un objeto para su eliminación.
  • removal_tid (Tuple(UInt64, UInt64, UUID)) — ID de la transacción que ha eliminado o está intentando eliminar este objeto
  • creation_csn (UInt64) — CSN de la transacción que creó este objeto
  • removal_csn (UInt64) — CSN de la transacción que eliminó este objeto
  • has_lightweight_delete (UInt8) — El indicador que señala si la parte tiene una máscara de eliminación ligera.
  • last_removal_attempt_time (DateTime) — La última vez que el servidor intentó eliminar esta parte.
  • removal_state (String) — El estado actual del proceso de eliminación de partes.

​
Ejemplo

SELECT * FROM system.parts LIMIT 1 FORMAT Vertical;

Row 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:                     []

​
Ver también

Última modificación el 10 de junio de 2026