> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ajustes de sesión max_*

> Ajustes de sesión de ClickHouse del grupo generado max_*.

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>;
};

export const ExperimentalBadge = () => {
  return <div className="experimentalBadge">
            <div className="experimentalIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path strokeWidth="1.25" d="M5.5 2H10.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path strokeWidth="1.25" d="M9.50015 2V6.19625L13.4283 12.7425C13.4738 12.8183 13.4985 12.9049 13.4996 12.9934C13.5008 13.0818 13.4785 13.169 13.435 13.246C13.3914 13.323 13.3283 13.3871 13.2519 13.4317C13.1755 13.4764 13.0886 13.4999 13.0002 13.5H3.00015C2.91164 13.5 2.8247 13.4766 2.74822 13.432C2.67174 13.3874 2.60847 13.3233 2.56487 13.2463C2.52126 13.1693 2.49889 13.082 2.50004 12.9935C2.50119 12.905 2.52582 12.8184 2.5714 12.7425L6.50015 6.19625V2" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path strokeWidth="1.25" d="M4.47656 9.56754C5.30344 9.41254 6.47656 9.47942 7.99969 10.25C10.0153 11.2707 11.4216 11.0569 12.2184 10.7282" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
            </svg>
        </div>
            Funcionalidad experimental. <u><a href="/docs/docs/beta-and-experimental-features#experimental-features">Más información.</a></u>
        </div>;
};

Estos ajustes están disponibles en [system.settings](/docs/es/reference/system-tables/settings) y se generan automáticamente a partir del [código fuente](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).

<div id="max_analyze_depth">
  ## max\_analyze\_depth
</div>

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

Cantidad máxima de análisis que realiza el intérprete.

<div id="max_autoincrement_series">
  ## max\_autoincrement\_series
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "1000"},{"label": "Una nueva configuración"}]}]} />

El límite de la cantidad de series creadas por la función `generateSerialID`.

Como cada serie representa un nodo en Keeper, se recomienda no tener más de un par de millones.

<div id="max_backup_bandwidth">
  ## max\_backup\_bandwidth
</div>

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

La velocidad máxima de lectura, en bytes por segundo, para una copia de seguridad concreta en el servidor. Cero significa que no hay límite.

<div id="max_block_size">
  ## max\_block\_size
</div>

<SettingsInfoBlock type="NonZeroUInt64" default_value="65409" />

En ClickHouse, los datos se procesan en bloques, que son conjuntos de partes de columnas. Los ciclos internos de procesamiento de un solo bloque son eficientes, pero procesar cada bloque conlleva costes apreciables.

La configuración `max_block_size` indica el número máximo recomendado de filas que se deben incluir en un solo bloque al cargar datos desde tablas. No siempre se cargan de la tabla bloques del tamaño de `max_block_size`: si ClickHouse determina que es necesario recuperar menos datos, se procesa un bloque más pequeño.

El tamaño del bloque no debe ser demasiado pequeño, para evitar costes apreciables al procesar cada bloque. Tampoco debe ser demasiado grande, para garantizar que las consultas con una cláusula LIMIT se ejecuten rápidamente después de procesar el primer bloque. Al configurar `max_block_size`, el objetivo debe ser evitar consumir demasiada memoria al extraer un gran número de columnas en varios hilos y preservar al menos cierta localidad de caché.

<div id="max_columns_to_read">
  ## max\_columns\_to\_read
</div>

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

El número máximo de columnas que se pueden leer de una tabla en una sola consulta.
Si una consulta requiere leer más columnas que el número especificado, se lanza una excepción.

<Tip>
  Esta configuración es útil para evitar consultas demasiado complejas.
</Tip>

El valor `0` significa que no hay límite.

<div id="max_compress_block_size">
  ## max\_compress\_block\_size
</div>

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

El tamaño máximo de los bloques de datos no comprimidos antes de comprimirlos para escribirlos en una tabla. El valor predeterminado es 1,048,576 (1 MiB). Especificar un tamaño de bloque más pequeño suele reducir ligeramente la relación de compresión; la velocidad de compresión y descompresión aumenta un poco debido a la localidad de caché, y se reduce el consumo de memoria.

<Note>
  Esta es una configuración de nivel experto y no debería cambiarla si apenas está empezando con ClickHouse.
</Note>

No confunda los bloques para compresión (un fragmento de memoria compuesto por bytes) con los bloques para el procesamiento de consultas (un conjunto de filas de una tabla).

<div id="max_consume_snapshots">
  ## max\_consume\_snapshots
</div>

<ExperimentalBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.5"},{"label": "0"},{"label": "Nueva configuración."}]}]} />

Número máximo de snapshots de Paimon que se pueden consumir en cada lectura incremental. 0 significa sin límite.

<div id="max_estimated_execution_time">
  ## max\_estimated\_execution\_time
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.1"},{"label": "0"},{"label": "Separa max_execution_time y max_estimated_execution_time"}]}]} />

Tiempo máximo estimado de ejecución de la consulta, en segundos. Se comprueba en cada bloque de datos
cuando se agota [`timeout_before_checking_execution_speed`](/docs/es/reference/settings/session-settings/other#timeout_before_checking_execution_speed).

<div id="max_expanded_ast_elements">
  ## max\_expanded\_ast\_elements
</div>

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

Tamaño máximo del árbol de sintaxis de la consulta, en número de nodos, tras la expansión de alias y del asterisco.

<div id="max_fetch_partition_retries_count">
  ## max\_fetch\_partition\_retries\_count
</div>

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

Número de reintentos al recuperar una partición desde otro host.

<div id="max_final_threads">
  ## max\_final\_threads
</div>

<SettingsInfoBlock type="MaxThreads" default_value="auto(N)" />

Establece el número máximo de hilos en paralelo para la fase de lectura de datos de la consulta `SELECT` con el modificador [FINAL](/docs/es/reference/statements/select/from#final-modifier).

Valores posibles:

* Entero positivo.
* 0 o 1 — Desactivado. Las consultas `SELECT` se ejecutan en un solo hilo.

<div id="max_http_get_redirects">
  ## max\_http\_get\_redirects
</div>

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

Número máximo de saltos de redirección HTTP GET permitidos. Garantiza que haya medidas de seguridad adicionales para evitar que un servidor malicioso redirija sus solicitudes a servicios inesperados.\n\nEsto ocurre cuando un servidor externo redirige a otra dirección, pero esa dirección parece ser interna a la infraestructura de la empresa y, al enviar una solicitud HTTP a un servidor interno, podría solicitar una API interna desde la red interna, omitir la autenticación o incluso consultar otros servicios, como Redis o Memcached. Si no tiene una infraestructura interna (incluido algo que se ejecute en su localhost), o si confía en el servidor, es seguro permitir redirecciones. No obstante, tenga en cuenta que, si la URL usa HTTP en lugar de HTTPS, tendrá que confiar no solo en el servidor remoto, sino también en su ISP y en todas las redes intermedias.

Valor predeterminado de Cloud: `10`.

<div id="max_limit_for_vector_search_queries">
  ## max\_limit\_for\_vector\_search\_queries
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "1000"},{"label": "Nuevo ajuste"}]}]} />

Las consultas SELECT con un LIMIT superior a este ajuste no pueden usar índices de similitud vectorial. Esto ayuda a evitar desbordamientos de memoria en los índices de similitud vectorial.

<div id="max_number_of_partitions_for_independent_aggregation">
  ## max\_number\_of\_partitions\_for\_independent\_aggregation
</div>

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

Número máximo de particiones de la tabla para aplicar la optimizació

<div id="max_os_cpu_wait_time_ratio_to_throw">
  ## max\_os\_cpu\_wait\_time\_ratio\_to\_throw
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "0"},{"label": "Se cambiaron los valores de la configuración y se aplicaron mediante backport a 25.4"}]}, {"id": "row-2","items": [{"label": "25.4"},{"label": "0"},{"label": "Nueva configuración"}]}]} />

Proporción máxima entre los tiempos de espera de la CPU del SO (métrica OSCPUWaitMicroseconds) y de actividad (métrica OSCPUVirtualTimeMicroseconds) para considerar rechazar consultas. Se utiliza interpolación lineal entre la proporción mínima y la máxima para calcular la probabilidad; en este punto, la probabilidad es 1.

<div id="max_parallel_replicas">
  ## max\_parallel\_replicas
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "1000"},{"label": "Usa hasta 1000 réplicas en paralelo de forma predeterminada."}]}]} />

El número máximo de réplicas para cada segmento al ejecutar una consulta.

Posibles valores:

* Entero positivo.

**Información adicional**

Esta opción puede producir resultados diferentes según la configuración utilizada.

<div id="parallel-processing-using-sample-key">
  ### Procesamiento en paralelo con la clave `SAMPLE`
</div>

Una consulta puede procesarse más rápido si se ejecuta en varios servidores en paralelo. Sin embargo, el rendimiento de la consulta puede degradarse en los siguientes casos:

* La posición de la clave de muestreo dentro de la clave de partición no permite realizar exploraciones de rango eficientes.
* Añadir una clave de muestreo a la tabla hace que el filtrado por otras columnas sea menos eficiente.
* La clave de muestreo es una expresión costosa de calcular.
* La distribución de latencia del clúster tiene una cola larga, por lo que consultar más servidores aumenta la latencia total de la consulta.

<div id="parallel-processing-using-parallel_replicas_custom_keyreferencesettingssession-settingsparallel-replicasparallel_replicas_custom_key">
  ### Procesamiento en paralelo mediante [parallel\_replicas\_custom\_key](/docs/es/reference/settings/session-settings/parallel-replicas#parallel_replicas_custom_key)
</div>

Esta configuración es útil para cualquier tabla replicada.

<div id="max_parsing_threads">
  ## max\_parsing\_threads
</div>

<SettingsInfoBlock type="MaxThreads" default_value="auto(N)" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.4"},{"label": "0"},{"label": "Añade una configuración independiente para controlar el número de hilos del análisis en paralelo de archivos"}]}]} />

El número máximo de hilos para analizar datos en formatos de entrada que admiten análisis en paralelo. De forma predeterminada, se calcula automáticamente.

<div id="max_partition_size_to_drop">
  ## max\_partition\_size\_to\_drop
</div>

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

Restricción para eliminar particiones en tiempo de consulta. El valor `0` significa que puede eliminar particiones sin ninguna restricción.

Valor predeterminado en Cloud: 1 TB.

<Note>
  Esta configuración de consulta anula la configuración equivalente del servidor; consulte [max\_partition\_size\_to\_drop](/docs/es/reference/settings/server-settings/settings#max_partition_size_to_drop)
</Note>

<div id="max_parts_to_move">
  ## max\_parts\_to\_move
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "1000"},{"label": "Nueva configuración"}]}]} />

Limita la cantidad de partes que se pueden mover en una sola consulta. Cero significa que no hay límite.

<div id="max_projection_rows_to_use_projection_index">
  ## max\_projection\_rows\_to\_use\_projection\_index
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.11"},{"label": "1000000"},{"label": "Nueva configuración"}]}]} />

Si el número de filas que se leerán del índice de proyección es menor o igual que este umbral, ClickHouse intentará aplicar el índice de proyección durante la ejecución de la consulta.

<div id="max_query_size">
  ## max\_query\_size
</div>

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

El número máximo de bytes de una cadena de consulta que analiza el analizador de SQL.
Los datos de la cláusula VALUES de las consultas INSERT se procesan mediante un analizador de flujo independiente (que consume O(1) de RAM) y no se ven afectados por esta restricción.

<Note>
  `max_query_size` no puede establecerse dentro de una consulta SQL (por ejemplo, `SELECT now() SETTINGS max_query_size=10000`) porque ClickHouse necesita asignar un búfer para analizar la consulta, y el tamaño de ese búfer lo determina la configuración `max_query_size`, que debe establecerse antes de ejecutar la consulta.
</Note>

<div id="max_recursive_cte_evaluation_depth">
  ## max\_recursive\_cte\_evaluation\_depth
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.4"},{"label": "1000"},{"label": "Profundidad máxima de evaluación de CTE recursivas"}]}]} />

Profundidad máxima de evaluación de CTE recursivas

<div id="max_replica_delay_for_distributed_queries">
  ## max\_replica\_delay\_for\_distributed\_queries
</div>

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

Deshabilita las réplicas con retraso en las consultas distribuidas. Consulte [Replicación](/docs/es/reference/engines/table-engines/mergetree-family/replication).

Establece el tiempo en segundos. Si el retraso de una réplica es mayor o igual que el valor establecido, esa réplica no se utiliza.

Valores posibles:

* Entero positivo.
* 0 — No se comprueba el retraso de las réplicas.

Para evitar el uso de cualquier réplica con un retraso distinto de cero, establezca este parámetro en 1.

Se usa al ejecutar `SELECT` en una tabla distribuida que apunta a tablas replicadas.

<div id="max_reverse_dictionary_lookup_cache_size_bytes">
  ## max\_reverse\_dictionary\_lookup\_cache\_size\_bytes
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.12"},{"label": "104857600"},{"label": "Nueva configuración. Tamaño máximo en bytes de la caché de búsqueda inversa en Diccionario por consulta usada por la función `dictGetKeys`. La caché almacena tuplas de claves serializadas por valor de atributo para evitar volver a escanear el Diccionario dentro de la misma consulta."}]}]} />

Tamaño máximo en bytes de la caché de búsqueda inversa en Diccionario por consulta usada por la función `dictGetKeys`. La caché almacena tuplas de claves serializadas por valor de atributo para evitar volver a escanear el Diccionario dentro de la misma consulta. Cuando se alcanza el límite, las entradas se desalojan mediante LRU. Establezca 0 para desactivar la caché.

<div id="max_sessions_for_user">
  ## max\_sessions\_for\_user
</div>

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

Número máximo de sesiones simultáneas por usuario autenticado en el servidor de ClickHouse.

Ejemplo:

```xml theme={null}
<profiles>
    <single_session_profile>
        <max_sessions_for_user>1</max_sessions_for_user>
    </single_session_profile>
    <two_sessions_profile>
        <max_sessions_for_user>2</max_sessions_for_user>
    </two_sessions_profile>
    <unlimited_sessions_profile>
        <max_sessions_for_user>0</max_sessions_for_user>
    </unlimited_sessions_profile>
</profiles>
<users>
    <!-- User Alice can connect to a ClickHouse server no more than once at a time. -->
    <Alice>
        <profile>single_session_user</profile>
    </Alice>
    <!-- User Bob can use 2 simultaneous sessions. -->
    <Bob>
        <profile>two_sessions_profile</profile>
    </Bob>
    <!-- User Charles can use arbitrarily many of simultaneous sessions. -->
    <Charles>
        <profile>unlimited_sessions_profile</profile>
    </Charles>
</users>
```

Valores posibles:

* Entero positivo
* `0` - número infinito de sesiones simultáneas (predeterminado)

<div id="max_subquery_depth">
  ## max\_subquery\_depth
</div>

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

Si una consulta tiene más subconsultas anidadas que el número especificado, se genera una
excepción.

<Tip>
  Esto le permite realizar una comprobación básica para evitar que los usuarios de su
  clúster escriban consultas excesivamente complejas.
</Tip>

<div id="max_table_size_to_drop">
  ## max\_table\_size\_to\_drop
</div>

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

Restricción para eliminar tablas en tiempo de consulta. El valor `0` significa que puede eliminar todas las tablas sin ninguna restricción.

Valor predeterminado de Cloud: 1 TB.

<Note>
  Esta configuración de consulta anula la configuración equivalente del servidor; consulte [max\_table\_size\_to\_drop](/docs/es/reference/settings/server-settings/settings#max_table_size_to_drop)
</Note>

<div id="max_untracked_memory">
  ## max\_untracked\_memory
</div>

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

Las asignaciones y liberaciones de memoria pequeñas se agrupan en una variable local del thread y solo se rastrean o perfilan cuando una cantidad (en valor absoluto) supera el valor especificado. Si este valor es mayor que 'memory\_profiler\_step', se reducirá en la práctica a 'memory\_profiler\_step'.

<div id="max_wkb_geometry_elements">
  ## max\_wkb\_geometry\_elements
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.4"},{"label": "1000000"},{"label": "Nueva configuración para limitar la cantidad de elementos en el análisis de geometrías WKB y evitar asignaciones de memoria excesivas con datos malformados."}]}]} />

Número máximo de puntos, anillos o polígonos permitidos en un único elemento de geometría WKB durante el análisis realizado por `readWKB` y funciones relacionadas. Esto protege frente a asignaciones de memoria excesivas causadas por datos WKB malformados. Establézcalo en 0 para usar el límite codificado de forma fija (100 millones).