> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.mintlify.site/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 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.settings](/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).

## s3\_base

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.8"},{"label": ""},{"label": "Nueva configuración para especificar la URL base para resolver URL relativas en la función de tabla s3 y el motor de tabla S3."}]}]} />

La URL base que se utiliza para resolver URL relativas en la función de tabla [s3](/es/reference/functions/table-functions/s3) y el motor de tabla [S3](/es/reference/engines/table-engines/integrations/s3), así como en las funciones de tabla que comparten su configuración (`s3Cluster`, `gcs`, `oss`).

Cuando se configura, una URL sin esquema se resuelve con respecto a `s3_base` conforme a RFC 3986, siguiendo las mismas reglas que [url\_base](/es/reference/settings/session-settings/url#url_base). Las URL que ya contienen un esquema se utilizan tal cual.

Por ejemplo, si `s3_base` es `s3://clickhouse-public-datasets/`, `s3('hits_compatible/hits.csv')` lee `s3://clickhouse-public-datasets/hits_compatible/hits.csv`.

La URL base puede usar cualquier formato aceptado por la función de tabla `s3`, por ejemplo, `s3://bucket/`, `https://bucket.s3.amazonaws.com/` o `https://endpoint/bucket/`.

## s3\_check\_objects\_after\_upload

<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

## s3\_connect\_timeout\_ms

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

## s3\_create\_new\_file\_on\_insert

<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í](/es/integrations/connectors/data-ingestion/AWS/integrating-s3-with-clickhouse#inserting-data).

## s3\_ignore\_file\_doesnt\_exist

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

## s3\_list\_object\_keys\_size

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

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

## s3\_min\_upload\_part\_size

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

## s3\_path\_filter\_limit

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

## s3\_request\_timeout\_ms

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

## s3\_skip\_empty\_files

<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](/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.

## s3\_slow\_all\_threads\_after\_network\_error

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

## s3\_strict\_upload\_part\_size

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

## s3\_throw\_on\_zero\_files\_match

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

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

## s3\_truncate\_on\_insert

<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í](/es/integrations/connectors/data-ingestion/AWS/integrating-s3-with-clickhouse#inserting-data).

## s3\_uri\_style

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

## s3\_use\_adaptive\_timeouts

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