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

# page_cache_* セッション設定

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

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](/docs/ja/reference/system-tables/settings) で確認でき、[ソースコード](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp) から自動生成されています。

<div id="page_cache_block_size">
  ## page\_cache\_block\_size
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "1048576"},{"label": "この設定をクエリ単位で調整できるようにしました。"}]}]} />

ユーザー空間ページキャッシュ に保存するファイル chunk のサイズ (バイト単位) です。cache を経由するすべての読み取りは、このサイズの倍数に切り上げられます。

この設定はクエリ単位で調整できますが、block サイズが異なる cache エントリは再利用できません。この設定を変更すると、実質的に cache 内の既存エントリは無効になります。

1 MiB のような大きな値は高スループットのクエリに適しており、64 KiB のような小さな値は低レイテンシのポイントクエリに適しています。

<div id="page_cache_inject_eviction">
  ## page\_cache\_inject\_eviction
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.3"},{"label": "0"},{"label": "ユーザー空間ページキャッシュを追加"}]}]} />

ユーザー空間ページキャッシュでは、ランダムに一部のページが無効化されることがあります。テスト用です。

<div id="page_cache_lookahead_blocks">
  ## page\_cache\_lookahead\_blocks
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "16"},{"label": "この設定をクエリ単位で調整できるようにしました。"}]}]} />

ユーザー空間のページキャッシュでキャッシュミスが発生した場合、後続の連続ブロックもキャッシュにないときは、基盤となるストレージから一度に最大でこの数まで読み込みます。各ブロックのサイズは `page_cache_block_size` バイトです。

値を大きくすると高スループットのクエリに適しており、低レイテンシのポイントクエリでは先読みを行わないほうが適しています。

<div id="page_cache_max_coalesced_bytes">
  ## page\_cache\_max\_coalesced\_bytes
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.5"},{"label": "16777216"},{"label": "キャッシュミス時にユーザー空間ページキャッシュを拡充するために使用される、単一の結合読み取りサイズを制限する新しい設定。"}]}]} />

`readBigAt` がユーザー空間ページキャッシュを拡充する際、連続するキャッシュミスは基盤となるストレージからの 1 回の読み取りに結合されます。この設定は、1 回の結合読み取りのサイズをバイト単位で制限します。より長いミスの連続は複数の読み取りに分割されます。これにより、並列コールド読み取り時の一時バッファの瞬間的なメモリ使用量が抑えられます。

値を大きくすると、オブジェクトストレージに対するコールドスキャン時の HTTP リクエスト数が減り、値を小さくするとピーク時の一時メモリ使用量が減ります。