> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-postgresql-tls-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# configuración de tablas MergeTree shared_merge_*

> Configuración de tablas MergeTree de ClickHouse en el grupo generado shared_merge_*.

export const VersionHistory = ({rows = []}) => {
  if (rows.length === 0) {
    return null;
  }
  const headers = ["Versión", "Valor predeterminado", "Comentario"];
  const border = "1px solid rgba(128, 128, 128, 0.3)";
  const cell = {
    border,
    padding: "0.25rem 0.5rem",
    textAlign: "start",
    verticalAlign: "top"
  };
  return <details className="not-prose" style={{
    border,
    borderRadius: "0.5rem",
    margin: "0.5rem 0",
    padding: "0.5rem 0.75rem",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <summary style={{
    cursor: "pointer",
    fontWeight: 600,
    opacity: 0.72
  }}>
        Historial de versiones
      </summary>
      <table style={{
    borderCollapse: "collapse",
    width: "100%",
    margin: "0.5rem 0 0"
  }}>
        <thead>
          <tr>
            {headers.map(header => <th key={header} style={{
    ...cell,
    fontWeight: 600,
    opacity: 0.72
  }}>
                {header}
              </th>)}
          </tr>
        </thead>
        <tbody>
          {rows.map((row, row_index) => <tr key={row.id ?? row_index}>
              {(row.items ?? []).map((item, item_index) => <td key={item_index} style={{
    ...cell,
    overflowWrap: "anywhere"
  }}>
                  {item?.label}
                </td>)}
            </tr>)}
        </tbody>
      </table>
    </details>;
};

export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
  return <div className="not-prose" style={{
    display: "flex",
    flexWrap: "wrap",
    alignItems: "baseline",
    columnGap: "0.5rem",
    rowGap: "0.125rem",
    margin: "0.375rem 0",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <div style={{
    fontWeight: 600,
    opacity: 0.72
  }}>Tipo</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{type}</div>
      <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>Predeterminado</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          Modificable sin reiniciar
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

Estos ajustes están disponibles en [system.merge\_tree\_settings](/es/reference/system-tables/merge_tree_settings) y se generan automáticamente a partir del código fuente de ClickHouse.

<div id="shared_merge_tree_activate_coordinated_merges_tasks">
  ## shared\_merge\_tree\_activate\_coordinated\_merges\_tasks
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

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.

<div id="shared_merge_tree_create_per_replica_metadata_nodes">
  ## shared\_merge\_tree\_create\_per\_replica\_metadata\_nodes
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

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

<div id="shared_merge_tree_disable_merges_and_mutations_assignment">
  ## shared\_merge\_tree\_disable\_merges\_and\_mutations\_assignment
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

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

<div id="shared_merge_tree_empty_partition_lifetime">
  ## shared\_merge\_tree\_empty\_partition\_lifetime
</div>

<SettingsInfoBlock type="Segundos" default_value="86400" />

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

<div id="shared_merge_tree_enable_automatic_empty_partitions_cleanup">
  ## shared\_merge\_tree\_enable\_automatic\_empty\_partitions\_cleanup
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

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

<div id="shared_merge_tree_enable_coordinated_merges">
  ## shared\_merge\_tree\_enable\_coordinated\_merges
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

Habilita la estrategia de fusiones coordinadas

<div id="shared_merge_tree_enable_keeper_parts_extra_data">
  ## shared\_merge\_tree\_enable\_keeper\_parts\_extra\_data
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

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

<div id="shared_merge_tree_enable_outdated_parts_check">
  ## shared\_merge\_tree\_enable\_outdated\_parts\_check
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

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

<div id="shared_merge_tree_idle_parts_update_seconds">
  ## shared\_merge\_tree\_idle\_parts\_update\_seconds
</div>

<SettingsInfoBlock type="UInt64" default_value="3600" />

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

<div id="shared_merge_tree_inactive_replica_cutoff_seconds">
  ## shared\_merge\_tree\_inactive\_replica\_cutoff\_seconds
</div>

<SettingsInfoBlock type="Segundos" default_value="0" />

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

<div id="shared_merge_tree_initial_parts_update_backoff_ms">
  ## shared\_merge\_tree\_initial\_parts\_update\_backoff\_ms
</div>

<SettingsInfoBlock type="UInt64" default_value="50" />

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

<div id="shared_merge_tree_interserver_http_connection_timeout_ms">
  ## shared\_merge\_tree\_interserver\_http\_connection\_timeout\_ms
</div>

<SettingsInfoBlock type="UInt64" default_value="100" />

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

<div id="shared_merge_tree_interserver_http_timeout_ms">
  ## shared\_merge\_tree\_interserver\_http\_timeout\_ms
</div>

<SettingsInfoBlock type="UInt64" default_value="10000" />

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

<div id="shared_merge_tree_leader_update_period_random_add_seconds">
  ## shared\_merge\_tree\_leader\_update\_period\_random\_add\_seconds
</div>

<SettingsInfoBlock type="UInt64" default_value="10" />

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

<div id="shared_merge_tree_leader_update_period_seconds">
  ## shared\_merge\_tree\_leader\_update\_period\_seconds
</div>

<SettingsInfoBlock type="UInt64" default_value="30" />

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

<div id="shared_merge_tree_max_outdated_parts_to_process_at_once">
  ## shared\_merge\_tree\_max\_outdated\_parts\_to\_process\_at\_once
</div>

<SettingsInfoBlock type="UInt64" default_value="1000" />

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.

<div id="shared_merge_tree_max_parts_update_backoff_ms">
  ## shared\_merge\_tree\_max\_parts\_update\_backoff\_ms
</div>

<SettingsInfoBlock type="UInt64" default_value="5000" />

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

<div id="shared_merge_tree_max_parts_update_leaders_in_total">
  ## shared\_merge\_tree\_max\_parts\_update\_leaders\_in\_total
</div>

<SettingsInfoBlock type="UInt64" default_value="6" />

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

<div id="shared_merge_tree_max_parts_update_leaders_per_az">
  ## shared\_merge\_tree\_max\_parts\_update\_leaders\_per\_az
</div>

<SettingsInfoBlock type="UInt64" default_value="2" />

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

<div id="shared_merge_tree_max_replicas_for_parts_deletion">
  ## shared\_merge\_tree\_max\_replicas\_for\_parts\_deletion
</div>

<SettingsInfoBlock type="UInt64" default_value="10" />

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

<div id="shared_merge_tree_max_replicas_to_merge_parts_for_each_parts_range">
  ## shared\_merge\_tree\_max\_replicas\_to\_merge\_parts\_for\_each\_parts\_range
</div>

<SettingsInfoBlock type="UInt64" default_value="5" />

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

<div id="shared_merge_tree_max_suspicious_broken_parts">
  ## shared\_merge\_tree\_max\_suspicious\_broken\_parts
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

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

<div id="shared_merge_tree_max_suspicious_broken_parts_bytes">
  ## shared\_merge\_tree\_max\_suspicious\_broken\_parts\_bytes
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

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

<div id="shared_merge_tree_memo_ids_remove_timeout_seconds">
  ## shared\_merge\_tree\_memo\_ids\_remove\_timeout\_seconds
</div>

<SettingsInfoBlock type="Int64" default_value="1800" />

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

<div id="shared_merge_tree_merge_coordinator_distribution_algorithm">
  ## shared\_merge\_tree\_merge\_coordinator\_distribution\_algorithm
</div>

<SettingsInfoBlock type="MergeCoordinatorDistributionAlgorithm" default_value="water_filling" />

Algoritmo que usará el hilo del coordinador de fusión para distribuir las fusiones entre réplicas

<div id="shared_merge_tree_merge_coordinator_election_check_period_ms">
  ## shared\_merge\_tree\_merge\_coordinator\_election\_check\_period\_ms
</div>

<SettingsInfoBlock type="Milisegundos" default_value="30000" />

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

<div id="shared_merge_tree_merge_coordinator_factor">
  ## shared\_merge\_tree\_merge\_coordinator\_factor
</div>

<SettingsInfoBlock type="Float" default_value="1.1" />

Factor de ajuste del tiempo de espera del hilo del coordinador

<div id="shared_merge_tree_merge_coordinator_fetch_fresh_metadata_period_ms">
  ## shared\_merge\_tree\_merge\_coordinator\_fetch\_fresh\_metadata\_period\_ms
</div>

<SettingsInfoBlock type="Milisegundos" default_value="10000" />

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

<div id="shared_merge_tree_merge_coordinator_max_merge_request_size">
  ## shared\_merge\_tree\_merge\_coordinator\_max\_merge\_request\_size
</div>

<SettingsInfoBlock type="UInt64" default_value="20" />

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

<div id="shared_merge_tree_merge_coordinator_max_period_ms">
  ## shared\_merge\_tree\_merge\_coordinator\_max\_period\_ms
</div>

<SettingsInfoBlock type="Milisegundos" default_value="10000" />

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

<div id="shared_merge_tree_merge_coordinator_merges_prepare_count">
  ## shared\_merge\_tree\_merge\_coordinator\_merges\_prepare\_count
</div>

<SettingsInfoBlock type="UInt64Auto" default_value="auto" />

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.

<div id="shared_merge_tree_merge_coordinator_min_period_ms">
  ## shared\_merge\_tree\_merge\_coordinator\_min\_period\_ms
</div>

<SettingsInfoBlock type="Milisegundos" default_value="1" />

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

<div id="shared_merge_tree_merge_worker_fast_timeout_ms">
  ## shared\_merge\_tree\_merge\_worker\_fast\_timeout\_ms
</div>

<SettingsInfoBlock type="Milisegundos" default_value="100" />

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

<div id="shared_merge_tree_merge_worker_regular_timeout_ms">
  ## shared\_merge\_tree\_merge\_worker\_regular\_timeout\_ms
</div>

<SettingsInfoBlock type="Milisegundos" default_value="10000" />

Tiempo entre ejecuciones del hilo de trabajo de merge

<div id="shared_merge_tree_outdated_parts_group_size">
  ## shared\_merge\_tree\_outdated\_parts\_group\_size
</div>

<SettingsInfoBlock type="UInt64" default_value="2" />

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.

<div id="shared_merge_tree_partitions_hint_ratio_to_reload_merge_pred_for_mutations">
  ## shared\_merge\_tree\_partitions\_hint\_ratio\_to\_reload\_merge\_pred\_for\_mutations
</div>

<SettingsInfoBlock type="Float" default_value="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

<div id="shared_merge_tree_parts_load_batch_size">
  ## shared\_merge\_tree\_parts\_load\_batch\_size
</div>

<SettingsInfoBlock type="UInt64" default_value="32" />

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

<div id="shared_merge_tree_postpone_next_merge_for_locally_merged_parts_ms">
  ## shared\_merge\_tree\_postpone\_next\_merge\_for\_locally\_merged\_parts\_ms
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

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.

<div id="shared_merge_tree_postpone_next_merge_for_locally_merged_parts_rows_threshold">
  ## shared\_merge\_tree\_postpone\_next\_merge\_for\_locally\_merged\_parts\_rows\_threshold
</div>

<SettingsInfoBlock type="UInt64" default_value="1000000" />

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.

<div id="shared_merge_tree_range_for_merge_window_size">
  ## shared\_merge\_tree\_range\_for\_merge\_window\_size
</div>

<SettingsInfoBlock type="UInt64" default_value="10" />

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

<div id="shared_merge_tree_read_virtual_parts_from_leader">
  ## shared\_merge\_tree\_read\_virtual\_parts\_from\_leader
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

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

<div id="shared_merge_tree_replica_set_max_lifetime_seconds">
  ## shared\_merge\_tree\_replica\_set\_max\_lifetime\_seconds
</div>

<SettingsInfoBlock type="Segundos" default_value="1800" />

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.

<div id="shared_merge_tree_try_fetch_part_in_memory_data_from_replicas">
  ## shared\_merge\_tree\_try\_fetch\_part\_in\_memory\_data\_from\_replicas
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

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.).

<div id="shared_merge_tree_try_fetch_part_in_memory_data_from_replicas_on_startup">
  ## shared\_merge\_tree\_try\_fetch\_part\_in\_memory\_data\_from\_replicas\_on\_startup
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

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.

<div id="shared_merge_tree_update_replica_flags_delay_ms">
  ## shared\_merge\_tree\_update\_replica\_flags\_delay\_ms
</div>

<SettingsInfoBlock type="Milisegundos" default_value="30000" />

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

<div id="shared_merge_tree_use_metadata_hints_cache">
  ## shared\_merge\_tree\_use\_metadata\_hints\_cache
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

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

<div id="shared_merge_tree_use_outdated_parts_compact_format">
  ## shared\_merge\_tree\_use\_outdated\_parts\_compact\_format
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

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

<div id="shared_merge_tree_use_too_many_parts_count_from_virtual_parts">
  ## shared\_merge\_tree\_use\_too\_many\_parts\_count\_from\_virtual\_parts
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

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

<div id="shared_merge_tree_use_zookeeper_connection_pool">
  ## shared\_merge\_tree\_use\_zookeeper\_connection\_pool
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

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

<div id="shared_merge_tree_virtual_parts_discovery_batch">
  ## shared\_merge\_tree\_virtual\_parts\_discovery\_batch
</div>

<SettingsInfoBlock type="UInt64" default_value="1" />

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

<div id="shared_merge_tree_virtual_parts_partition_atomic_discovery">
  ## shared\_merge\_tree\_virtual\_parts\_partition\_atomic\_discovery
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

Indica si SMT descubrirá la partición de partes virtuales de forma atómica con recuperación adicional de datos y configuración de watches.