Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

configuración de tablas MergeTree shared_merge_*

Estos ajustes están disponibles en system.merge_tree_settings y se generan automáticamente a partir del código fuente de ClickHouse.

shared_merge_tree_activate_coordinated_merges_tasks

Tipo
Bool
Predeterminado
0
Historial de versiones
VersiónValor predeterminadoComentario
25.90Nuevos ajustes
25.80Nuevos ajustes
25.70Nuevos ajustes
25.60Nuevos ajustes
25.100Nuevos ajustes

Activa la replanificación de las tareas de fusiones coordinadas. Puede ser útil incluso cuando shared_merge_tree_enable_coordinated_merges=0, porque así se poblarán las estadísticas del coordinador de fusiones y se facilitará el arranque en frío.

shared_merge_tree_blobs_list_inline_file_max_bytes

Tipo
UInt64
Predeterminado
0
Historial de versiones
VersiónValor predeterminadoComentario
26.90Nueva configuración que almacena en línea los archivos pequeños de una parte de lista de blobs en el archivo blobs.list consolidado en lugar de en blobs independientes

Almacena directamente en el archivo blobs.list consolidado los archivos de una parte de lista de blobs cuyo tamaño sea como máximo este número de bytes (p. ej., count.txt, metadata_version.txt, índices minmax), en lugar de en un blob independiente de almacenamiento de objetos, lo que ahorra una escritura y una lectura de blob por cada archivo pequeño. El valor 0 desactiva el almacenamiento en línea. Solo tiene efecto para las partes que usan el almacenamiento de lista de blobs (consulta shared_merge_tree_use_blobs_list_for_parts). Solo disponible en ClickHouse Cloud.

shared_merge_tree_create_per_replica_metadata_nodes

Tipo
Bool
Predeterminado
0
Historial de versiones
VersiónValor predeterminadoComentario
25.110Reduce la cantidad de metadatos en Keeper.
25.11Sincronización en Cloud

Habilita la creación de nodos /metadata y /columns para cada réplica en ZooKeeper. Solo disponible en ClickHouse Cloud

shared_merge_tree_disable_merges_and_mutations_assignment

Tipo
Bool
Predeterminado
0

Detiene la asignación de merges en shared merge tree. Solo disponible en ClickHouse Cloud

shared_merge_tree_empty_partition_lifetime

Tipo
Segundos
Predeterminado
86400
Historial de versiones
VersiónValor predeterminadoComentario
25.9Nueva configuración86400

Cuántos segundos se almacenará una partición en Keeper si no tiene partes.

shared_merge_tree_enable_automatic_empty_partitions_cleanup

Tipo
Bool
Predeterminado
1
Historial de versiones
VersiónValor predeterminadoComentario
26.21Habilitado de forma predeterminada
25.90Nueva configuración

Habilita la limpieza de las entradas de Keeper correspondientes a particiones vacías.

shared_merge_tree_enable_coordinated_merges

Tipo
Bool
Predeterminado
1
Historial de versiones
VersiónValor predeterminadoComentario
26.61Habilita las fusiones coordinadas de forma predeterminada
25.50Nueva configuración

Habilita la estrategia de fusiones coordinadas

shared_merge_tree_enable_keeper_parts_extra_data

Tipo
Bool
Predeterminado
1
Historial de versiones
VersiónValor predeterminadoComentario
26.61Habilita las fusiones coordinadas de forma predeterminada
25.30Nueva configuración

Permite escribir atributos en partes virtuales y hacer commit de bloques en Keeper

shared_merge_tree_enable_outdated_parts_check

Tipo
Bool
Predeterminado
1
Historial de versiones
VersiónValor predeterminadoComentario
25.11Sincronización en Cloud

Habilita la comprobación de partes obsoletas. Solo disponible en ClickHouse Cloud

shared_merge_tree_idle_parts_update_seconds

Tipo
UInt64
Predeterminado
3600
Historial de versiones
VersiónValor predeterminadoComentario
25.13600Sincronización en Cloud

Intervalo en segundos para la actualización de partes sin activarse por un watch de ZooKeeper en el shared merge tree. Solo disponible en ClickHouse Cloud

shared_merge_tree_inactive_replica_cutoff_seconds

Tipo
Segundos
Predeterminado
0
Historial de versiones
VersiónValor predeterminadoComentario
26.60Nueva configuración que controla durante cuánto tiempo se tiene en cuenta una réplica inactiva en la limpieza en segundo plano (0 significa dos timeouts de sesión de ZooKeeper)

Durante cuánto tiempo se sigue teniendo en cuenta una réplica inactiva en la limpieza en segundo plano (OutdatedPartsQuorumThread): mientras una réplica haya estado inactiva durante menos de esta cantidad de segundos, seguirá retrasando la eliminación de partes obsoletas y el truncado de las mutaciones finalizadas. Un valor de 0 significa usar el valor predeterminado de dos timeouts de sesión de ZooKeeper. Solo en ClickHouse Cloud

shared_merge_tree_initial_parts_update_backoff_ms

Tipo
UInt64
Predeterminado
50
Historial de versiones
VersiónValor predeterminadoComentario
25.250Nueva configuración

Retardo inicial para la actualización de partes. Solo disponible en ClickHouse Cloud

shared_merge_tree_interserver_http_connection_timeout_ms

Tipo
UInt64
Predeterminado
100
Historial de versiones
VersiónValor predeterminadoComentario
25.2100Nueva configuración

Tiempos de espera para la conexión HTTP entre servidores. Disponible solo en ClickHouse Cloud

shared_merge_tree_interserver_http_timeout_ms

Tipo
UInt64
Predeterminado
10000
Historial de versiones
VersiónValor predeterminadoComentario
25.110000Sincronización en Cloud

Tiempos de espera para la comunicación HTTP entre servidores. Solo disponible en ClickHouse Cloud

shared_merge_tree_leader_update_period_random_add_seconds

Tipo
UInt64
Predeterminado
10
Historial de versiones
VersiónValor predeterminadoComentario
25.110Sincronización en Cloud

Añade un valor con distribución uniforme de 0 a x segundos a shared_merge_tree_leader_update_period para evitar el efecto de estampida. Solo disponible en ClickHouse Cloud

shared_merge_tree_leader_update_period_seconds

Tipo
UInt64
Predeterminado
30
Historial de versiones
VersiónValor predeterminadoComentario
25.130Sincronización en Cloud

Período máximo para volver a comprobar el liderazgo en la actualización de partes. Solo disponible en ClickHouse Cloud

shared_merge_tree_max_outdated_parts_to_process_at_once

Tipo
UInt64
Predeterminado
1000
Historial de versiones
VersiónValor predeterminadoComentario
25.11000Sincronización en Cloud

Número máximo de partes obsoletas cuya eliminación el líder intentará confirmar en una sola solicitud HTTP. Solo disponible en ClickHouse Cloud.

shared_merge_tree_max_parts_update_backoff_ms

Tipo
UInt64
Predeterminado
5000
Historial de versiones
VersiónValor predeterminadoComentario
25.25000Nueva configuración

Tiempo máximo de retardo para la actualización de partes. Solo disponible en ClickHouse Cloud

shared_merge_tree_max_parts_update_leaders_in_total

Tipo
UInt64
Predeterminado
6
Historial de versiones
VersiónValor predeterminadoComentario
25.16Sincronización en Cloud

Número máximo total de líderes de actualización de partes. Solo disponible en ClickHouse Cloud

shared_merge_tree_max_parts_update_leaders_per_az

Tipo
UInt64
Predeterminado
2
Historial de versiones
VersiónValor predeterminadoComentario
25.12Sincronización en Cloud

Número máximo de líderes de actualización de partes. Solo disponible en ClickHouse Cloud

shared_merge_tree_max_replicas_for_parts_deletion

Tipo
UInt64
Predeterminado
10
Historial de versiones
VersiónValor predeterminadoComentario
25.110Sincronización en Cloud

Número máximo de réplicas que participarán en la eliminación de partes (hilo killer). Solo disponible en ClickHouse Cloud

shared_merge_tree_max_replicas_to_merge_parts_for_each_parts_range

Tipo
UInt64
Predeterminado
5
Historial de versiones
VersiónValor predeterminadoComentario
25.15Sincronización en Cloud

Número máximo de réplicas que intentarán asignar fusiones potencialmente conflictivas (para evitar conflictos redundantes en la asignación de fusiones). 0 significa que está deshabilitado. Solo disponible en ClickHouse Cloud

shared_merge_tree_max_suspicious_broken_parts

Tipo
UInt64
Predeterminado
0
Historial de versiones
VersiónValor predeterminadoComentario
25.20Número máximo de partes dañadas para SMT; si hay más, impedir el desacople automático

Número máximo de partes dañadas para SMT; si hay más, impedir el desacople automático.

shared_merge_tree_max_suspicious_broken_parts_bytes

Tipo
UInt64
Predeterminado
0
Historial de versiones
VersiónValor predeterminadoComentario
25.20Tamaño máximo total de las partes dañadas para SMT; si se supera, se impide el desacople automático

Tamaño máximo total de las partes dañadas para SMT; si se supera, se impide el desacople automático.

shared_merge_tree_memo_ids_remove_timeout_seconds

Tipo
Int64
Predeterminado
1800
Historial de versiones
VersiónValor predeterminadoComentario
25.11800Sincronización en Cloud

Cuánto tiempo se almacenan los identificadores de memoización de insert para evitar acciones incorrectas durante los reintentos de insert. Solo disponible en ClickHouse Cloud

shared_merge_tree_merge_coordinator_distribution_algorithm

Tipo
MergeCoordinatorDistributionAlgorithm
Predeterminado
sainte_lague
Historial de versiones
VersiónValor predeterminadoComentario
26.8sainte_lagueHabilita la distribución Sainte-Lague de forma predeterminada.
26.7water_fillingNueva configuración que controla qué algoritmo utiliza el coordinador de fusión para distribuir las fusiones entre réplicas

El algoritmo que utiliza el hilo del coordinador de fusión para distribuir las fusiones entre réplicas.

Valores posibles:

  • water_filling
  • sainte_lague

shared_merge_tree_merge_coordinator_election_check_period_ms

Tipo
Milisegundos
Predeterminado
30000
Historial de versiones
VersiónValor predeterminadoComentario
25.530000Nueva configuración

Intervalo entre ejecuciones del hilo de elección del coordinador de fusión

shared_merge_tree_merge_coordinator_factor

Tipo
Float
Predeterminado
1.1
Historial de versiones
VersiónValor predeterminadoComentario
25.51.100000023841858Nueva configuración
25.101.100000023841858Menor tiempo de espera del coordinador tras la carga

Factor de ajuste del tiempo de espera del hilo del coordinador

shared_merge_tree_merge_coordinator_fetch_fresh_metadata_period_ms

Tipo
Milisegundos
Predeterminado
10000
Historial de versiones
VersiónValor predeterminadoComentario
25.510000Nueva configuración

Frecuencia con la que el coordinador de fusión debe sincronizarse con ZooKeeper para obtener metadatos actualizados

shared_merge_tree_merge_coordinator_max_merge_request_size

Tipo
UInt64
Predeterminado
20
Historial de versiones
VersiónValor predeterminadoComentario
25.520Nueva configuración

Número de fusiones que el coordinador puede solicitar a MergerMutator a la vez

shared_merge_tree_merge_coordinator_max_period_ms

Tipo
Milisegundos
Predeterminado
10000
Historial de versiones
VersiónValor predeterminadoComentario
25.510000Nueva configuración

Tiempo máximo entre ejecuciones del hilo del coordinador de fusiones

shared_merge_tree_merge_coordinator_merges_prepare_count

Tipo
UInt64Auto
Predeterminado
auto
Historial de versiones
VersiónValor predeterminadoComentario
26.4autoConfigura el ajuste en auto: máximo de tareas de fusión por réplica * número de réplicas activas
25.5100Nueva configuración

Número de entradas de fusión que el coordinador debe preparar y distribuir entre los workers. Cuando se establece en 'auto', equivale al número máximo de tareas de fusión permitidas en una sola réplica multiplicado por el número de réplicas activas.

shared_merge_tree_merge_coordinator_min_period_ms

Tipo
Milisegundos
Predeterminado
1
Historial de versiones
VersiónValor predeterminadoComentario
25.51Nueva configuración

Intervalo mínimo entre ejecuciones del hilo del coordinador de fusión

shared_merge_tree_merge_worker_fast_timeout_ms

Tipo
Milisegundos
Predeterminado
100
Historial de versiones
VersiónValor predeterminadoComentario
25.5100Nueva configuración

Tiempo de espera que utilizará el hilo merge worker si necesita actualizar su estado tras una acción inmediata

shared_merge_tree_merge_worker_regular_timeout_ms

Tipo
Milisegundos
Predeterminado
10000
Historial de versiones
VersiónValor predeterminadoComentario
25.510000Nueva configuración

Tiempo entre ejecuciones del hilo de trabajo de merge

shared_merge_tree_outdated_parts_group_size

Tipo
UInt64
Predeterminado
2
Historial de versiones
VersiónValor predeterminadoComentario
25.92Nueva configuración

Número de réplicas que estarán en el mismo grupo de hash de rendezvous para la limpieza de partes obsoletas. Solo disponible en ClickHouse Cloud.

shared_merge_tree_partitions_hint_ratio_to_reload_merge_pred_for_mutations

Tipo
Float
Predeterminado
0.5

Recargará el predicado de merge en la tarea de selección de merge/mutate cuando la proporción de <candidate partitions for mutations only (partitions that cannot be merged)>/<candidate partitions for mutations> sea superior al valor de esta configuración. Solo disponible en ClickHouse Cloud

shared_merge_tree_parts_load_batch_size

Tipo
UInt64
Predeterminado
32

Cantidad de trabajos de recuperación de metadatos de partes que se programan simultáneamente. Solo disponible en ClickHouse Cloud

shared_merge_tree_postpone_next_merge_for_locally_merged_parts_ms

Tipo
UInt64
Predeterminado
0
Historial de versiones
VersiónValor predeterminadoComentario
25.10Sincronización en Cloud

Tiempo durante el que se conserva una parte fusionada localmente sin iniciar una nueva fusión que la incluya. Esto da a otras réplicas la oportunidad de obtener la parte e iniciar esta fusión. Solo disponible en ClickHouse Cloud.

shared_merge_tree_postpone_next_merge_for_locally_merged_parts_rows_threshold

Tipo
UInt64
Predeterminado
1000000
Historial de versiones
VersiónValor predeterminadoComentario
25.11000000Sincronización en Cloud

Tamaño mínimo de la parte (en filas) para posponer la asignación de la siguiente fusión justo después de fusionarla localmente. Solo disponible en ClickHouse Cloud.

shared_merge_tree_range_for_merge_window_size

Tipo
UInt64
Predeterminado
10
Historial de versiones
VersiónValor predeterminadoComentario
25.110Sincronización en Cloud

Tamaño de la ventana (en números de bloque) que se utiliza para distribuir la asignación de fusiones entre réplicas. Las partes dentro de la misma ventana se asignan a las mismas réplicas. Solo disponible en ClickHouse Cloud

shared_merge_tree_read_virtual_parts_from_leader

Tipo
Bool
Predeterminado
1
Historial de versiones
VersiónValor predeterminadoComentario
25.11Sincronización en Cloud

Leer las partes virtuales del líder cuando sea posible. Solo disponible en ClickHouse Cloud

shared_merge_tree_replica_set_max_lifetime_seconds

Tipo
Segundos
Predeterminado
1800
Historial de versiones
VersiónValor predeterminadoComentario
26.41800Aumenta el intervalo predeterminado de actualización en segundo plano del conjunto de réplicas a 30 minutos
26.2300Nueva configuración

Frecuencia con la que las réplicas intentarán actualizar el conjunto de réplicas en segundo plano. La siguiente ejecución se programa con una variación aleatoria uniforme en [0, value] segundos. Excepción: value = 0 no sigue ese criterio; la implementación aplica un mínimo de 200 ms, por lo que la siguiente ejecución se programa con una variación aleatoria en [0, 200] ms.

shared_merge_tree_try_fetch_part_in_memory_data_from_replicas

Tipo
Bool
Predeterminado
0
Historial de versiones
VersiónValor predeterminadoComentario
25.10Nueva configuración para obtener datos en memoria de las partes desde otras réplicas

Si está habilitada, todas las réplicas intentan obtener de otras réplicas, donde ya existen, los datos en memoria de la parte (como la clave primaria, la información de la partición, etc.).

shared_merge_tree_try_fetch_part_in_memory_data_from_replicas_on_startup

Tipo
Bool
Predeterminado
0
Historial de versiones
VersiónValor predeterminadoComentario
26.60Nueva configuración que permite a SMT descargar al iniciarse los datos en memoria de las partes desde las réplicas en lugar de S3

Si está habilitada, todas las réplicas intentan obtener al iniciarse los datos en memoria de la parte (como la clave primaria, la información de la partición, etc.) desde otras réplicas donde ya existen.

shared_merge_tree_update_replica_flags_delay_ms

Tipo
Milisegundos
Predeterminado
30000
Historial de versiones
VersiónValor predeterminadoComentario
25.830000Nueva configuración

Frecuencia con la que la réplica intentará recargar sus indicadores según la programación en segundo plano.

shared_merge_tree_use_blobs_list_for_parts

Tipo
Bool
Predeterminado
0
Historial de versiones
VersiónValor predeterminadoComentario
26.90Nueva configuración que almacena el mapa de blobs por archivo de una parte de SharedMergeTree en un único nodo consolidado de Keeper, en lugar de un nodo por archivo

Almacena las partes de una tabla SharedMergeTree (tanto Wide como Compact) en un único nodo de metadatos consolidado con una lista de blobs, en lugar de un nodo de Keeper por archivo. Reduce los metadatos de Keeper por parte de O(archivos) a una pequeña constante, mientras mantiene un blob en el almacenamiento de objetos por archivo. Disponible solo en ClickHouse Cloud.

shared_merge_tree_use_metadata_hints_cache

Tipo
Bool
Predeterminado
1
Historial de versiones
VersiónValor predeterminadoComentario
25.11Sincronización en Cloud

Permite solicitar sugerencias de caché de FS desde la caché en memoria de otras réplicas. Solo disponible en ClickHouse Cloud

shared_merge_tree_use_outdated_parts_compact_format

Tipo
Bool
Predeterminado
1
Historial de versiones
VersiónValor predeterminadoComentario
25.91Habilitar las partes obsoletas v3 de forma predeterminada
25.10Sincronización en Cloud

Utiliza el formato compacto para las partes obsoletas: reduce la carga en Keeper y mejora el procesamiento de las partes obsoletas. Solo disponible en ClickHouse Cloud

shared_merge_tree_use_too_many_parts_count_from_virtual_parts

Tipo
Bool
Predeterminado
0
Historial de versiones
VersiónValor predeterminadoComentario
25.10Sincronización en Cloud

Si está habilitado, el contador de demasiadas partes utilizará los datos compartidos en Keeper, en lugar del estado local de la réplica. Solo disponible en ClickHouse Cloud

shared_merge_tree_use_zookeeper_connection_pool

Tipo
Bool
Predeterminado
0
Historial de versiones
VersiónValor predeterminadoComentario
26.30Nueva configuración

Si está habilitado, SharedMergeTree usa una de las sesiones de ZooKeeper agrupadas a nivel de servidor.

shared_merge_tree_virtual_parts_discovery_batch

Tipo
UInt64
Predeterminado
1
Historial de versiones
VersiónValor predeterminadoComentario
25.81Nueva configuración

Cuántos descubrimientos de particiones se deben agrupar en un lote

shared_merge_tree_virtual_parts_partition_atomic_discovery

Tipo
Bool
Predeterminado
1
Historial de versiones
VersiónValor predeterminadoComentario
26.71Nueva configuración

Configuración obsoleta, no hace nada.

Navigation