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

# filesystem_cache_* セッション設定

> filesystem_cache_* の生成グループに含まれる ClickHouse のセッション設定。

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>
            {'ClickHouse Cloud 専用'}
        </div>;
};

export const VersionHistory = ({rows = []}) => {
  if (rows.length === 0) {
    return null;
  }
  const headers = ["バージョン", "デフォルト値", "コメント"];
  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
  }}>
        バージョン履歴
      </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
  }}>型</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{type}</div>
      <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>デフォルト値</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          再起動せずに変更可能
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

これらの設定は [system.settings](/ja/reference/system-tables/settings) で確認でき、[ソースコード](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": "クエリごとのファイルシステムキャッシュでのバックグラウンドダウンロードを制御するための新しい設定。"}]}]} />

リモートストレージから読み取ったデータについて、ファイルシステムキャッシュがバックグラウンドダウンロードをキューに追加できるようにします。無効にすると、現在のクエリ/セッションではダウンロードはフォアグラウンドで実行されます。

<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": "新しい設定"}]}]} />

ファイルシステムキャッシュの境界アラインメント。この設定は、ディスク以外からの読み取りにのみ適用されます (たとえば、リモートテーブルエンジン / テーブル関数の cache には適用されますが、MergeTree テーブルのストレージ構成には適用されません) 。値が 0 の場合、アラインメントは行われません。

<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": "新しい設定"}]}]} />

ClickHouse Cloud でのみ有効です。ファイルシステムキャッシュで領域を予約するためにcacheをロックするまでの待機時間

<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": "新しい設定"}]}]} />

ClickHouse Cloud でのみ有効です。ファイルシステムキャッシュ内の領域を予約するためにキャッシュをロックするまでの待機時間

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

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

1 回のクエリでダウンロードできるリモートファイルシステムキャッシュの最大サイズ

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": ""},{"label": "ステートレスなテーブルエンジンまたはデータレイクで使用するファイルシステムキャッシュの名前"}]}]} />

ステートレスなテーブルエンジンまたはデータレイクで使用するファイルシステムキャッシュの名前

<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": "新しい設定"}]}]} />

ファイルシステムキャッシュが有効な場合、cache のパフォーマンスを低下させる小さなファイルセグメントの書き込みを避けるため、より大きなバッファサイズを優先します。一方、この設定を有効にすると、メモリ使用量が増える可能性があります。

<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": "ファイルシステムキャッシュで領域を予約するためにキャッシュをロックするまでの待機時間"}]}]} />

ファイルシステムキャッシュで領域を予約するためにキャッシュをロックするまでの待機時間

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

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

読み取りバッファが cache から 1 回のバッチでリクエストできるファイルセグメント数の上限です。値が低すぎると cache へのリクエストが過剰になり、値が大きすぎると cache からのエビクションが遅くなる可能性があります

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

**別名**: `skip_download_if_exceeds_query_cache`

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.11"},{"label": "1"},{"label": "設定 skip_download_if_exceeds_query_cache_limit の名称変更"}]}]} />

クエリキャッシュのサイズ制限を超える場合、リモートファイルシステムからのダウンロードをスキップします

<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": "ログレベルが許可していれば以前は無条件に出力されていた、ファイルシステムキャッシュの読み取りバッファの再充填ごとのTESTレベルのログメッセージを制御する新しい設定。"}]}]} />

ファイルシステムキャッシュのバッファ再充填ごとに、`TEST` レベルのログメッセージ (読み取りの状態、残りの読み取りサイズ、読み取ったバイト数) を出力します。デバッグ専用です。メッセージは読み取りごとに一度整形されるため、多数の小さなキャッシュ済み読み取りを行うクエリで有効にすると、大きなロギングオーバーヘッドが発生します。メッセージが表示されるのは、いずれにしてもログレベルが `test` の場合のみです (`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": "同時実行クエリによってファイルシステムキャッシュにダウンロード中のファイルセグメントを読み取りが待機する時間を制限する新しい設定です。timeout になると、読み取りは無期限に待機せず、cacheをバイパスします。以前の値60000は、従来の動作（ダウンローダーでの完全な60秒間の待機サイクル1回）に相当します。"}]}]} />

同時実行クエリによってファイルシステムキャッシュにダウンロード中のファイルセグメントを待機する最大時間です。timeout に達すると、読み取りはその範囲ではファイルシステムキャッシュをバイパスし、リモートストレージから直接読み取ります。同時実行ダウンロードはその間もcacheの充填を続けます。値`0`は、まったく待機しないことを意味します。必要な範囲がまだダウンロードされていない場合は、直ちにcacheをバイパスします。この値を小さくすると、リモートストレージへの追加リクエストが増える代わりに、別のクエリのダウンロード速度を待機する可能性があるcacheヒット読み取りのtail latencyを抑えられます。