> ## 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 de s3_*

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

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.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="s3_check_objects_after_upload">
  ## s3\_check\_objects\_after\_upload
</div>

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

Comprueba cada objeto cargado en S3 con una solicitud head para asegurarte de que la carga se haya completado correctamente

<div id="s3_connect_timeout_ms">
  ## s3\_connect\_timeout\_ms
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.3"},{"label": "1000"},{"label": "Nueva configuración específica para el tiempo de espera de conexión de S3"}]}]} />

Tiempo de espera de conexión al host para discos S3.

<div id="s3_create_new_file_on_insert">
  ## s3\_create\_new\_file\_on\_insert
</div>

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

Habilita o deshabilita la creación de un archivo nuevo con cada inserción en las tablas con motor S3. Si se habilita, en cada inserción se creará un nuevo objeto en S3 con la clave, siguiendo un patrón como este:

inicial: `data.Parquet.gz` -> `data.1.Parquet.gz` -> `data.2.Parquet.gz`, etc.

Valores posibles:

* 0 — la consulta `INSERT` crea un archivo nuevo o falla si el archivo ya existe y no se ha configurado s3\_truncate\_on\_insert.
* 1 — la consulta `INSERT` crea un archivo nuevo con cada inserción usando un sufijo (a partir del segundo) si no se ha configurado s3\_truncate\_on\_insert.

Consulta más detalles [aquí](/docs/es/integrations/connectors/data-ingestion/AWS/integrating-s3-with-clickhouse#inserting-data).

<div id="s3_disable_checksum">
  ## s3\_disable\_checksum
</div>

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

No calcule una suma de comprobación al enviar un archivo a S3. Esto acelera las escrituras al evitar un procesamiento excesivo del archivo. Por lo general, es seguro, ya que los datos de las tablas MergeTree de todos modos ya tienen suma de comprobación en ClickHouse y, cuando se accede a S3 mediante HTTPS, la capa TLS ya proporciona integridad durante la transferencia a través de la red. Aun así, las sumas de comprobación adicionales en S3 aportan una defensa en profundidad.

<div id="s3_ignore_file_doesnt_exist">
  ## s3\_ignore\_file\_doesnt\_exist
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.6"},{"label": "0"},{"label": "Permite devolver 0 filas cuando los archivos solicitados no existen en lugar de lanzar una excepción en el motor de tabla S3"}]}]} />

Ignora la ausencia de archivos al leer ciertas claves si no existen.

Posibles valores:

* 1 — `SELECT` devuelve un resultado vacío.
* 0 — `SELECT` lanza una excepción.

<div id="s3_list_object_keys_size">
  ## s3\_list\_object\_keys\_size
</div>

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

Número máximo de archivos que la solicitud ListObject puede devolver en un lote

<div id="s3_min_upload_part_size">
  ## s3\_min\_upload\_part\_size
</div>

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

El tamaño mínimo de la parte que se va a subir durante una carga multiparte a S3.

<div id="s3_path_filter_limit">
  ## s3\_path\_filter\_limit
</div>

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

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

Número máximo de valores de `_path` que pueden extraerse de los filtros de consulta para utilizarlos en la iteración de archivos
en lugar del listado con glob. 0 significa que está deshabilitado.

<div id="s3_request_timeout_ms">
  ## s3\_request\_timeout\_ms
</div>

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

Tiempo de espera de inactividad para enviar y recibir datos hacia/desde S3. Se produce un error si una única llamada TCP de lectura o escritura permanece bloqueada durante ese tiempo.

<div id="s3_skip_empty_files">
  ## s3\_skip\_empty\_files
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.11"},{"label": "1"},{"label": "Esperamos que ofrezca una mejor experiencia de usuario"}]}]} />

Habilita o deshabilita la omisión de archivos vacíos en las tablas con motor [S3](/docs/es/reference/engines/table-engines/integrations/s3).

Valores posibles:

* 0 — `SELECT` lanza una excepción si el archivo vacío no es compatible con el formato solicitado.
* 1 — `SELECT` devuelve un resultado vacío para un archivo vacío.

<div id="s3_slow_all_threads_after_network_error">
  ## s3\_slow\_all\_threads\_after\_network\_error
</div>

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

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

Cuando se establece en `true`, todos los hilos que ejecutan solicitudes a S3 hacia el mismo endpoint de copia de seguridad se ralentizan
después de que una sola solicitud a S3 encuentre un error de red reintentable, como un timeout de socket.
Cuando se establece en `false`, cada hilo gestiona el backoff de las solicitudes a S3 de forma independiente de los demás.

<div id="s3_strict_upload_part_size">
  ## s3\_strict\_upload\_part\_size
</div>

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

El tamaño exacto de la parte que se va a subir durante una carga multiparte en S3 (algunas implementaciones no admiten partes de tamaño variable).

<div id="s3_throw_on_zero_files_match">
  ## s3\_throw\_on\_zero\_files\_match
</div>

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

Genera un error cuando la solicitud ListObjects no encuentra ningún archivo

<div id="s3_truncate_on_insert">
  ## s3\_truncate\_on\_insert
</div>

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

Habilita o deshabilita el truncado antes de las inserciones en las tablas con motor S3. Si está deshabilitado, se lanzará una excepción al intentar insertar si ya existe un objeto en S3.

Valores posibles:

* 0 — la consulta `INSERT` crea un archivo nuevo o falla si el archivo ya existe y `s3_create_new_file_on_insert` no está configurado.
* 1 — la consulta `INSERT` reemplaza el contenido existente del archivo con los nuevos datos.

Consulta más detalles [aquí](/docs/es/integrations/connectors/data-ingestion/AWS/integrating-s3-with-clickhouse#inserting-data).

<div id="s3_uri_style">
  ## s3\_uri\_style
</div>

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

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

Fuerza el estilo del endpoint de S3. Valores posibles: auto, virtual\_hosted, path.

<div id="s3_use_adaptive_timeouts">
  ## s3\_use\_adaptive\_timeouts
</div>

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

Cuando se establece en `true`, en todas las solicitudes a S3 los dos primeros intentos se realizan con tiempos de espera de envío y recepción reducidos.
Cuando se establece en `false`, todos los intentos se realizan con tiempos de espera idénticos.
