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

# configuración de sesión de filesystem_cache_*

> Configuración de sesión de ClickHouse en el grupo generado filesystem_cache_*.

export const CloudOnlyBadge = () => {
  return <div className="cloudBadge">
            <div className="cloudIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path fillRule="evenodd" clipRule="evenodd" d="M5.33395 12.6667H12.3739C13.6593 12.6667 14.7073 11.6187 14.7073 10.3334C14.7073 9.04804 13.6593 8.00004 12.3739 8.00004H12.0839V7.33337C12.0839 5.12671 10.2906 3.33337 8.08395 3.33337C6.09928 3.33337 4.45395 4.78537 4.14195 6.68204C2.55728 6.76271 1.29395 8.06204 1.29395 9.66671C1.29395 11.3234 2.63728 12.6667 4.29395 12.6667H5.33395Z" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" />
            </svg>
        </div>
            {'Solo para ClickHouse Cloud'}
        </div>;
};

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

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

<div id="filesystem_cache_allow_background_download">
  ## filesystem\_cache\_allow\_background\_download
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.11"},{"label": "1"},{"label": "Nueva configuración para controlar las descargas en segundo plano en la caché del sistema de archivos para cada consulta."}]}]} />

Permite que la caché del sistema de archivos ponga en cola descargas en segundo plano para los datos leídos desde el almacenamiento remoto. Desactívelo para mantener las descargas en primer plano en la consulta o sesión actual.

<div id="filesystem_cache_boundary_alignment">
  ## filesystem\_cache\_boundary\_alignment
</div>

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

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

Alineación de los límites de la caché del sistema de archivos. Este ajuste se aplica solo a lecturas que no son de disco (por ejemplo, a la caché de motores de tabla remotos / funciones de tabla, pero no a la configuración de almacenamiento de las tablas MergeTree). El valor 0 significa que no hay alineación.

<div id="filesystem_cache_enable_background_download_during_fetch">
  ## filesystem\_cache\_enable\_background\_download\_during\_fetch
</div>

<CloudOnlyBadge />

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

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

Solo tiene efecto en ClickHouse Cloud. Tiempo de espera para bloquear la caché y reservar espacio en la caché del sistema de archivos

<div id="filesystem_cache_enable_background_download_for_metadata_files_in_packed_storage">
  ## filesystem\_cache\_enable\_background\_download\_for\_metadata\_files\_in\_packed\_storage
</div>

<CloudOnlyBadge />

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

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

Solo tiene efecto en ClickHouse Cloud. Tiempo de espera para bloquear la caché al reservar espacio en la caché del sistema de archivos

<div id="filesystem_cache_max_download_size">
  ## filesystem\_cache\_max\_download\_size
</div>

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

Tamaño máximo de la caché del sistema de archivos remoto que una sola consulta puede descargar

<div id="filesystem_cache_name">
  ## filesystem\_cache\_name
</div>

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": ""},{"label": "Nombre de la caché del sistema de archivos que se usará para los motores de tabla sin estado o los lagos de datos"}]}]} />

Nombre de la caché del sistema de archivos que se usará para los motores de tabla sin estado o los lagos de datos

<div id="filesystem_cache_prefer_bigger_buffer_size">
  ## filesystem\_cache\_prefer\_bigger\_buffer\_size
</div>

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

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

Se prefiere un tamaño de búfer mayor si la caché del sistema de archivos está habilitada para evitar escribir segmentos de archivo pequeños, que degradan el rendimiento de la caché. Por otro lado, habilitar esta configuración puede aumentar el uso de memoria.

<div id="filesystem_cache_reserve_space_wait_lock_timeout_milliseconds">
  ## filesystem\_cache\_reserve\_space\_wait\_lock\_timeout\_milliseconds
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.3"},{"label": "1000"},{"label": "Tiempo de espera para bloquear la caché al reservar espacio en la caché del sistema de archivos"}]}]} />

Tiempo de espera para bloquear la caché al reservar espacio en la caché del sistema de archivos

<div id="filesystem_cache_segments_batch_size">
  ## filesystem\_cache\_segments\_batch\_size
</div>

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

Límite del tamaño de un único lote de segmentos de archivo que un búfer de lectura puede solicitar a la caché. Un valor demasiado bajo provocará un exceso de solicitudes a la caché; uno demasiado alto puede ralentizar la expulsión de la caché

<div id="filesystem_cache_skip_download_if_exceeds_per_query_cache_write_limit">
  ## filesystem\_cache\_skip\_download\_if\_exceeds\_per\_query\_cache\_write\_limit
</div>

**Alias**: `skip_download_if_exceeds_query_cache`

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.11"},{"label": "1"},{"label": "Cambio de nombre de la configuración skip_download_if_exceeds_query_cache_limit"}]}]} />

Omite la descarga desde el sistema de archivos remoto si esta supera el tamaño de la caché de consultas

<div id="filesystem_cache_verbose_logging">
  ## filesystem\_cache\_verbose\_logging
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.8"},{"label": "0"},{"label": "Nueva configuración que controla los mensajes de registro de nivel TEST por cada recarga del búfer de lectura de la caché del sistema de archivos, que antes se emitían incondicionalmente cuando el nivel de registro lo permitía."}]}]} />

Emite mensajes de registro de nivel `TEST` por cada recarga del búfer de la caché del sistema de archivos (estado de lectura, tamaño restante por leer y bytes leídos). Solo para depuración: los mensajes se formatean una vez por lectura, por lo que habilitar esta opción en una consulta que realiza muchas lecturas pequeñas desde la caché añade una considerable sobrecarga de registro. De todos modos, los mensajes solo son visibles cuando el nivel de registro es `test` (consulte `send_logs_level`).

<div id="filesystem_cache_wait_for_concurrent_download_timeout_milliseconds">
  ## filesystem\_cache\_wait\_for\_concurrent\_download\_timeout\_milliseconds
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.8"},{"label": "1000"},{"label": "Nueva configuración que limita el tiempo que una lectura espera a que una consulta simultánea descargue un segmento de archivo en la caché del sistema de archivos; cuando se agota el tiempo de espera, la lectura omite la caché en lugar de esperar indefinidamente. El valor anterior, 60000, corresponde al comportamiento previo (un ciclo completo de espera de 60 s en el descargador)."}]}]} />

Tiempo máximo de espera por un segmento de archivo que una consulta simultánea está descargando en la caché del sistema de archivos. Cuando se agota el tiempo de espera, la lectura omite la caché del sistema de archivos para ese rango y lee directamente del almacenamiento remoto, mientras la descarga simultánea continúa llenando la caché. El valor `0` significa no esperar en absoluto: omite la caché de inmediato si el rango necesario aún no se ha descargado. Reducir este valor limita la latencia de cola de las lecturas que alcanzan la caché y que, de otro modo, esperarían al ritmo de descarga de otra consulta, a costa de solicitudes adicionales al almacenamiento remoto.