> ## 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 use_*

> Ajustes de sesión de ClickHouse en el grupo generado use_*.

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

Estas configuraciones 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="use_async_executor_for_materialized_views">
  ## use\_async\_executor\_for\_materialized\_views
</div>

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

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

Usa una ejecución asíncrona y, potencialmente, multihilo para la consulta de la vista materializada; puede acelerar el procesamiento de las vistas durante INSERT, pero también consumir más memoria.

<div id="use_cache_for_count_from_files">
  ## use\_cache\_for\_count\_from\_files
</div>

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

Habilita el almacenamiento en caché del número de filas al realizar conteos a partir de archivos en las funciones de tabla `file`/`s3`/`url`/`hdfs`/`azureBlobStorage`.

Está habilitado de forma predeterminada.

<div id="use_client_time_zone">
  ## use\_client\_time\_zone
</div>

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

Usa la zona horaria del client para interpretar los valores de cadena DateTime, en lugar de usar la zona horaria del server.

<div id="use_compact_format_in_distributed_parts_names">
  ## use\_compact\_format\_in\_distributed\_parts\_names
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "21.1"},{"label": "1"},{"label": "Usa de forma predeterminada el formato compacto para `INSERT` asíncronos en tablas `Distributed`"}]}]} />

Usa el formato compacto para almacenar bloques de `INSERT` en segundo plano (`distributed_foreground_insert`) en tablas con motor `Distributed`.

Valores posibles:

* 0 — Usa el formato de directorio `user[:password]@host:port#default_database`.
* 1 — Usa el formato de directorio `[shard{shard_index}[_replica{replica_index}]]`.

<Note>
  - con `use_compact_format_in_distributed_parts_names=0`, los cambios en la definición del clúster no se aplicarán al `INSERT` en segundo plano.
  - con `use_compact_format_in_distributed_parts_names=1`, cambiar el orden de los nodos en la definición del clúster cambiará `shard_index`/`replica_index`, así que tenlo en cuenta.
</Note>

<div id="use_concurrency_control">
  ## use\_concurrency\_control
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.12"},{"label": "1"},{"label": "Habilita el control de concurrencia de forma predeterminada"}]}]} />

Respeta el control de concurrencia del servidor (consulta los ajustes globales del servidor `concurrent_threads_soft_limit_num` y `concurrent_threads_soft_limit_ratio_to_cores`). Si se desactiva, permite usar un mayor número de hilos incluso si el servidor está sobrecargado (no se recomienda para el uso normal y se necesita principalmente para pruebas).

<div id="use_constant_folding_in_index_analysis">
  ## use\_constant\_folding\_in\_index\_analysis
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.7"},{"label": "0"},{"label": "Nueva configuración para incorporar constantes a nivel de partición en el predicado de filtro para cada parte durante el análisis de índices de MergeTree, lo que mejora la poda en filtros cuyas ramas dependen de valores de partición."}]}]} />

Sustituye constantes a nivel de partición en el predicado de filtro al analizar, para cada parte, la clave primaria y los skip indexes.

Cuando la clave de partición aparece en el filtro junto con columnas de la clave primaria o de skip indexes, esto permite que el análisis de índices incorpore el valor de la partición por separado dentro de cada parte. Resulta especialmente útil para filtros disyuntivos cuyas ramas se dirigen a distintas particiones. Por ejemplo, con `PARTITION BY a` y `ORDER BY b`:

```sql theme={null}
SELECT * FROM t WHERE (a = 1 AND b >= 1) OR (a = 2 AND b > 10) OR (a = 3 AND b > 10)
```

Para la parte de la partición `a = 1`, la condición se simplifica a `b >= 1`, mientras que para las particiones `a = 2` y `a = 3` se simplifica a `b > 10`, por lo que cada parte se analiza con el predicado que realmente se le aplica.

Valores posibles:

* 0 — Deshabilitado.
* 1 — Habilitado.

<div id="use_hash_table_stats_for_join_reordering">
  ## use\_hash\_table\_stats\_for\_join\_reordering
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.1"},{"label": "1"},{"label": "Nueva configuración. Anteriormente reflejaba la configuración 'collect_hash_table_stats_during_joins'."}]}]} />

Habilita el uso de las estadísticas recopiladas de la tabla hash para estimar la cardinalidad durante la reordenación de joins

<div id="use_hedged_requests">
  ## use\_hedged\_requests
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "21.9"},{"label": "1"},{"label": "Habilita la función de Hedged Requests de forma predeterminada"}]}]} />

Habilita la lógica de hedged requests para consultas remotas. Permite establecer varias conexiones con distintas réplicas para una consulta.
Se habilita una nueva conexión si la(s) conexión(es) existente(s) con la(s) réplica(s) no se han establecido dentro de `hedged_connection_timeout`
o si no se han recibido datos dentro de `receive_data_timeout`. La consulta usa la primera conexión que envía un paquete de progreso no vacío (o un paquete de datos, si `allow_changing_replica_until_first_data_packet`);
las demás conexiones se cancelan. Se admiten consultas con `max_parallel_replicas > 1`.

Habilitado de forma predeterminada.

Valor predeterminado de Cloud: `0`.

<div id="use_hive_partitioning">
  ## use\_hive\_partitioning
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "1"},{"label": "La configuración se habilitó de forma predeterminada."}]}, {"id": "row-2","items": [{"label": "24.8"},{"label": "0"},{"label": "Permite usar el particionamiento de estilo Hive para los motores File, URL, S3, AzureBlobStorage y HDFS."}]}]} />

Cuando está habilitada, ClickHouse detectará el particionamiento de estilo Hive en la ruta (`/name=value/`) en los motores de tabla tipo archivo [File](/docs/es/reference/functions/table-functions/file#hive-style-partitioning)/[S3](/docs/es/reference/functions/table-functions/s3#hive-style-partitioning)/[URL](/docs/es/reference/functions/table-functions/url#hive-style-partitioning)/[HDFS](/docs/es/reference/functions/table-functions/hdfs#hive-style-partitioning)/[AzureBlobStorage](/docs/es/reference/functions/table-functions/azureBlobStorage#hive-style-partitioning) y permitirá usar las columnas de partición como columnas virtuales en la consulta. Estas columnas virtuales tendrán los mismos nombres que en la ruta particionada, pero comenzarán por `_`.

<div id="use_join_disjunctions_push_down">
  ## use\_join\_disjunctions\_push\_down
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.1"},{"label": "1"},{"label": "Se habilitó esta optimización."}]}, {"id": "row-2","items": [{"label": "25.10"},{"label": "0"},{"label": "Nueva configuración."}]}]} />

Habilita el pushdown de las partes de las condiciones de JOIN conectadas por OR a los lados de entrada correspondientes ("pushdown parcial").
Esto permite que los motores de almacenamiento filtren antes, lo que puede reducir los datos leídos.
La optimización preserva la semántica y se aplica solo cuando cada rama OR de nivel superior aporta al menos un
predicado determinista para el lado de destino.

<div id="use_legacy_to_time">
  ## use\_legacy\_to\_time
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.7"},{"label": "0"},{"label": "Usa de forma predeterminada la nueva función `toTime` (que convierte valores al tipo de dato `Time`) en lugar de la función `toTime` legacy, que sigue disponible como `toTimeWithFixedDate`."}]}, {"id": "row-2","items": [{"label": "25.6"},{"label": "1"},{"label": "Nueva configuración. Permite al usuario usar la lógica anterior de la función `toTime`, que funciona como `toTimeWithFixedDate`."}]}]} />

Cuando está habilitada, permite usar la función `toTime` legacy, que convierte una fecha con hora en una fecha fija determinada, conservando la hora.
De lo contrario, se usa la nueva función `toTime`, que convierte distintos tipos de datos al tipo `Time`.
La función legacy anterior también está disponible incondicionalmente como `toTimeWithFixedDate`.

<div id="use_lightweight_primary_key_index_analysis">
  ## use\_lightweight\_primary\_key\_index\_analysis
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": "1"},{"label": "Nueva configuración para optimizar el análisis del índice de clave primaria en tablas con claves primarias largas"}]}]} />

Optimiza el análisis del índice de clave primaria para tablas `MergeTree` con claves primarias largas.

Cuando está habilitada, la duración del análisis del índice depende principalmente de la complejidad del filtro de la consulta (las columnas clave que realmente utiliza), y no de la longitud de la clave primaria; por tanto, ampliar la clave de ordenación apenas añade sobrecarga al análisis del índice en consultas que filtran solo por unas pocas de sus columnas.

Posibles valores:

* 0 — Deshabilitado. Durante el análisis del índice, se procesan todas las columnas de la clave primaria.
* 1 — Habilitado.

<div id="use_parquet_metadata_cache">
  ## use\_parquet\_metadata\_cache
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.3"},{"label": "1"},{"label": "Habilita la caché de metadatos de archivos Parquet."}]}]} />

Si está activado, el formato Parquet puede utilizar la caché de metadatos de Parquet.

Valores posibles:

* 0 - Deshabilitado
* 1 - Habilitado

<div id="use_primary_key">
  ## use\_primary\_key
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.1"},{"label": "1"},{"label": "Nueva configuración que controla si MergeTree usa la clave primaria para descartar gránulos."}]}]} />

Usa la clave primaria para descartar gránulos durante la ejecución de consultas en tablas MergeTree.

Valores posibles:

* 0 — Deshabilitado.
* 1 — Habilitado.

<div id="use_reader_executor">
  ## use\_reader\_executor
</div>

<ExperimentalBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": "0"},{"label": "Nueva configuración experimental para enrutar las lecturas a través del nuevo pipeline ReaderExecutor en lugar de la matrioshka heredada de búferes de lectura."}]}]} />

Experimental. Enruta las lecturas a través del nuevo pipeline `ReaderExecutor` en lugar de la matrioshka heredada de búferes de lectura. Recurre a la ruta heredada en las configuraciones que el ejecutor aún no admite.

<div id="use_roaring_bitmap_iceberg_positional_deletes">
  ## use\_roaring\_bitmap\_iceberg\_positional\_deletes
</div>

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

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

Usa un bitmap roaring para las eliminaciones posicionales de Iceberg.

<div id="use_streaming_marks_compression">
  ## use\_streaming\_marks\_compression
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.7"},{"label": "0"},{"label": "Nueva configuración para comprimir las marks en la representación en memoria un bloque cada vez (streaming), en lugar de materializar primero el array completo de marks sin comprimir, lo que reduce el uso máximo de memoria durante la carga de marks para partes compactas con muchos subflujos."}]}]} />

Al cargar marks para las partes de MergeTree, comprímalas en la representación en memoria un bloque cada vez (streaming), en lugar de materializar primero el array completo de marks sin comprimir. Esto reduce significativamente el uso máximo de memoria durante la carga de marks para partes compactas con muchos subflujos (p. ej., tablas con columnas JSON y write\_marks\_for\_substreams\_in\_compact\_parts habilitado).

<div id="use_strict_insert_block_limits">
  ## use\_strict\_insert\_block\_limits
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.4"},{"label": "0"},{"label": "Nueva configuración para aplicar límites mínimos y máximos estrictos a los bloques de inserción durante las inserciones. Cuando min < max, prevalecen los límites máximos."}]}]} />

Cuando está habilitada, aplica estrictamente tanto los límites mínimos como los máximos del tamaño del bloque de inserción.

Se emite un bloque cuando:

* Umbrales mínimos (AND): Se alcanzan tanto min\_insert\_block\_size\_rows como min\_insert\_block\_size\_bytes.
* Umbrales máximos (OR): Se alcanza max\_insert\_block\_size\_rows o max\_insert\_block\_size\_bytes.

Cuando está deshabilitada, se emite un bloque cuando:

* Umbrales mínimos (OR): Se alcanza min\_insert\_block\_size\_rows o min\_insert\_block\_size\_bytes.

**Nota**: Si la configuración máxima es menor que la mínima, prevalecen los límites máximos y los bloques se emitirán antes de que se alcancen los umbrales mínimos.

**Nota**: Esta configuración se deshabilita automáticamente para las inserciones asíncronas, porque las inserciones asíncronas asocian tokens de deduplicación por entrada que son incompatibles con la división de bloques necesaria para aplicar límites estrictos.

Deshabilitada de forma predeterminada.

<div id="use_structure_from_insertion_table_in_table_functions">
  ## use\_structure\_from\_insertion\_table\_in\_table\_functions
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "22.11"},{"label": "2"},{"label": "Mejora el uso de la estructura de la tabla de inserción en las funciones de tabla"}]}]} />

Usa la estructura de la tabla de inserción en lugar de inferir el esquema a partir de los datos. Valores posibles: 0 - deshabilitado, 1 - habilitado, 2 - automático

<div id="use_uncompressed_cache">
  ## use\_uncompressed\_cache
</div>

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

Indica si se debe usar una caché de bloques sin comprimir. Acepta 0 o 1. De forma predeterminada, 0 (deshabilitado).
Usar la caché sin comprimir (solo para tablas de la familia MergeTree) puede reducir significativamente la latencia y aumentar el rendimiento al trabajar con una gran cantidad de consultas cortas. Habilite esta configuración para los usuarios que envían solicitudes cortas con frecuencia. Preste atención también al parámetro de configuración [uncompressed\_cache\_size](/docs/es/reference/settings/server-settings/settings#uncompressed_cache_size) (solo se establece en el archivo de configuración), que define el tamaño de los bloques de la caché sin comprimir. De forma predeterminada, es de 8 GiB. La caché sin comprimir se rellena según sea necesario y los datos menos utilizados se eliminan automáticamente.

En las consultas que leen un volumen de datos relativamente grande (un millón de filas o más), la caché sin comprimir se deshabilita automáticamente para ahorrar espacio para las consultas realmente pequeñas. Esto significa que puede mantener la configuración `use_uncompressed_cache` siempre establecida en 1.

<div id="use_with_fill_by_sorting_prefix">
  ## use\_with\_fill\_by\_sorting\_prefix
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "23.5"},{"label": "1"},{"label": "Las columnas anteriores a las columnas WITH FILL en la cláusula ORDER BY constituyen el prefijo de ordenación. Las filas con valores distintos en el prefijo de ordenación se rellenan de manera independiente"}]}]} />

Las columnas anteriores a las columnas WITH FILL en la cláusula ORDER BY constituyen el prefijo de ordenación. Las filas con valores distintos en el prefijo de ordenación se rellenan de manera independiente
