system.parts

Tabla del sistema con información sobre las partes de MergeTree

​

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 partición (representación en cadena derivada de la expresión de la clave de partición).

• name (String) — Nombre de la parte de datos. La estructura de nomenclatura de la parte permite determinar muchos aspectos de los patrones de datos, ingesta y combinació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 mínimo de bloque de la parte. ClickHouse siempre fusiona bloques continuos
    • maximum_block_number - identifica el número máximo de bloque de la parte
    • level - se incrementa en uno con cada fusión adicional de la parte. Un nivel de 0 indica que se trata de 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 muta (de nuevo, los datos mutados siempre se escriben únicamente en una parte nueva, ya que las partes son inmutables)

• uuid (UUID) — El 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 único archivo. El formato de almacenamiento de datos se controla mediante las opciones min_bytes_for_wide_part y min_rows_for_wide_part de la tabla MergeTree.

• part_storage_type (String) — El tipo de DataPartStorage. Valores posibles: Packed — la mayoría de los archivos de la parte se almacenan en un único archivo; las proyecciones y algunos archivos de servicio, como txn_version.txt, se escriben por separado; Full — cada archivo se almacena por separado.

• active (UInt8) — Indicador que señala si la parte de datos está activa. Si una parte de datos está activa, se utiliza en una tabla. De lo contrario, está a punto de eliminarse. Las partes de datos inactivas aparecen después de operaciones de fusión y mutación.

• marks (UInt64) — El número de marcas. Para obtener el número aproximado de filas de 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) — El tamaño total, en bytes, de todos los archivos de la parte de datos.

• data_compressed_bytes (UInt64) — El tamaño total de los datos comprimidos de la parte de datos. No se incluyen los archivos auxiliares, como los archivos con marcas.

• data_uncompressed_bytes (UInt64) — El tamaño total de los datos sin comprimir de la parte de datos. No se incluyen los archivos auxiliares, como los archivos con marcas.

• primary_key_size (UInt64) — La cantidad de memoria, en bytes, utilizada por los valores de la clave primaria en el archivo primary.idx/cidx del disco.

• marks_bytes (UInt64) — El tamaño del archivo con marcas.

• secondary_indices_compressed_bytes (UInt64) — El tamaño total de los datos comprimidos de los índices secundarios en la parte de datos. No se incluyen los archivos auxiliares, como los archivos con marcas.

• secondary_indices_uncompressed_bytes (UInt64) — El tamaño total de los datos sin comprimir de los índices secundarios en la parte de datos. No se incluyen los archivos auxiliares, como los archivos con marcas.

• secondary_indices_marks_bytes (UInt64) — El tamaño del archivo con marcas de los índices secundarios.

• modification_time (DateTime) — La hora en que se modificó el directorio de la parte de datos. Normalmente, corresponde a la hora de creación de la parte de datos.

• remove_time (DateTime) — La hora en que la parte de datos pasó a estar inactiva.

• refcount (UInt32) — El número de usos de 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 en la parte de datos.

• max_date (Date) — El valor máximo de la clave de fecha en la parte de datos.

• min_time (DateTime) — El valor mínimo de la clave de fecha y hora en la parte de datos.

• max_time (DateTime) — El valor máximo de la clave de fecha y hora en la parte de datos.

• partition_id (String) — El ID 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 componen la parte actual tras la fusión.

• level (UInt32) — Profundidad del árbol de fusiones. Cero significa que la parte actual se creó mediante una inserción, en lugar de fusionando 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) — 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 no es cero, los bytes se almacenan en la propia parte y se contabilizan en jemalloc.mergetree_arena.active_bytes. NUNCA se contabilizan en PrimaryIndexCacheBytes: son mutuamente excluyentes para cada parte; un índice se encuentra en la parte (esta métrica) o en la PrimaryIndexCache compartida (la otra), según primary_key_lazy_load y use_primary_key_cache.

• primary_key_bytes_in_memory_allocated (UInt64) — 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 se haya cargado. Cuando no es cero, se incluye en jemalloc.mergetree_arena.active_bytes. Consulte la nota sobre primary_key_bytes_in_memory para conocer su relación con PrimaryIndexCacheBytes.

• index_granularity_bytes_in_memory (UInt64) — Cantidad de memoria (en bytes) utilizada por los valores de granularidad del índice (será 0 si primary_key_lazy_load=1 y use_primary_key_cache=1). Cuando no es cero, los bytes pertenecen a la parte y se contabilizan en jemalloc.mergetree_arena.active_bytes.

• index_granularity_bytes_in_memory_allocated (UInt64) — Cantidad de memoria (en bytes) reservada para los valores de granularidad del índice (será 0 si primary_key_lazy_load=1 y use_primary_key_cache=1). Cuando no es cero, se incluye en jemalloc.mergetree_arena.active_bytes.

• is_frozen (UInt8) — Indicador de la existencia de 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 tabla sin parámetros.

• disk_name (String) — Nombre del disco que almacena la parte de datos.

• path (String) — Ruta absoluta a 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 de marcas, archivo de índice, etc.).

• uncompressed_hash_of_compressed_files (String) — sipHash128 de los datos de los archivos comprimidos como si estuvieran sin comprimir.

• delete_ttl_info_min (DateTime) — Valor mínimo de la clave de fecha y hora para la regla TTL DELETE.

• delete_ttl_info_max (DateTime) — Valor máximo de la clave de fecha y hora para la regla TTL DELETE.

• move_ttl_info.expression (Array(String)) — Array de expresiones. Cada expresión define una regla 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 para una regla TTL MOVE.

• default_compression_codec (String) — El nombre del códec utilizado para comprimir esta parte de datos cuando una columna no tiene un códec explícito o usa CODEC(Default). Con allow_experimental_adaptive_codec_selection, los bloques individuales de dichas columnas pueden usar otros códecs; consulte mergeTreeCodecBlockCounts.

• 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 en esta parte. Se utiliza para determinar si hay al menos una fila con el TTL expirado.

• recompression_ttl_info.max (Array(DateTime)) — El valor máximo de la expresión TTL calculada en esta parte. Se utiliza para determinar si todas las filas tienen el TTL expirado.

• group_by_ttl_info.expression (Array(String)) — La expresión TTL.

• group_by_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 el TTL expirado.

• group_by_ttl_info.max (Array(DateTime)) — El valor máximo de la expresión TTL calculada en esta parte. Se utiliza para determinar si todas las filas tienen el TTL expirado.

• 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 el TTL expirado.

• rows_where_ttl_info.max (Array(DateTime)) — El valor máximo de la expresión TTL calculada en esta parte. Se utiliza para determinar si todas las filas tienen el TTL expirado.

• projections (Array(String)) — La lista de nombres de las proyecciones calculadas para esta parte.

• visible (UInt8) — Indicador que señala si esta parte es visible para 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, utilizado para bloquear un objeto para su eliminación.

• removal_tid (Tuple(UInt64, UInt64, UUID)) — ID de la transacción que eliminó 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) — 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 la parte.

Alias:

• bytes — Alias de bytes_on_disk.
• marks_size — Alias de marks_bytes.
• part_name — Alias de name.

​

Ejemplo

SELECT * FROM system.parts LIMIT 1 FORMAT Vertical;

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

​

Ver también

• Familia de MergeTree
• TTL para columnas y tablas