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

# columns_cache_* session settings

> 自動生成された columns_cache_* グループに含まれる ClickHouse の session settings。

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <span>ベータ</span>
            </a>;
  }
  return <a href="https://clickhouse.com/docs/reference/settings/beta-and-experimental-features#beta-features" className="betaBadge">
            <span>ベータ機能</span>
        </a>;
};

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

<h2 id="columns_cache_max_bytes_to_write_to_cache">
  columns\_cache\_max\_bytes\_to\_write\_to\_cache
</h2>

<BetaBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.10"},{"label": "0"},{"label": "新しい設定: カラムキャッシュに書き込まれるバイト数に対するクエリ単位のソフトしきい値です。目安であり、1つのリーダーが1回のバッチで書き込むエントリ分まで超過する場合があります（0 = 現在のカラムキャッシュサイズ上限の半分。この上限はメモリ逼迫時に縮小されます）。"}]}]} />

1つのクエリがカラムキャッシュに書き込むバイト数に対する、クエリ単位のソフトしきい値です。クエリ実行中に書き込まれたバイト数がカウントされ、カウンターがこの値に達すると、そのクエリの以降の処理ではキャッシュへの書き込みがスキップされます。これはあくまで目安となるしきい値であり、厳密な上限ではありません。リーダーは読み込んだグラニュールのエントリを蓄積し、1回のバッチでまとめてキャッシュに書き込みます。しきい値をまたぐバッチも、カウンターに加算される前に全体が格納されます。そのため実際の書き込み量は、1つのリーダーが2回の書き込みの間に蓄積するエントリ分 (読み込むカラムごとに、約65536行のストライプ1つにつき1エントリ) だけこの値を超える場合があり、複数のリーダーが同時に実行されている場合は、リーダーごとにその分だけ超過する可能性があります。この設定の目的は、単一の大規模なスキャンによって有用なデータがキャッシュから追い出されるのを防ぐことであり、キャッシュ使用量を厳密に制限することではありません。

値が `0` の場合は、カラムキャッシュの現在のサイズ上限の半分が使用されます。この上限は通常、設定された `columns_cache_size` ですが、メモリ逼迫によりキャッシュが縮小されている間はそれより小さくなります (`ColumnsCacheSizeLimit` メトリクスを参照してください) 。

<h2 id="columns_cache_max_estimated_bytes_to_write_to_cache">
  columns\_cache\_max\_estimated\_bytes\_to\_write\_to\_cache
</h2>

<BetaBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.10"},{"label": "0"},{"label": "新しい設定: カラムキャッシュへの書き込みを許可する、クエリが読み取る推定非圧縮バイト数の上限 (0 = 現在のカラムキャッシュサイズ上限の半分。この上限はメモリ逼迫時に縮小します)。"}]}]} />

クエリが `MergeTree` パーツから読み取るデータの推定サイズがこの値を超える場合、そのクエリ全体でカラムキャッシュへの書き込みが抑止されます。推定値は、キャッシュの使用量として計上される単位である非圧縮バイト数で算出されます。具体的には、クエリが読み取るカラム (`PREWHERE`、ミューテーション、パッチパーツのカラムを含む) のサイズを選択されたマーク範囲に応じてスケーリングした値であり、クエリが読み取りを開始する前にその全量が計上されます。これにより、単一の大規模なスキャンによってキャッシュ内の有用なデータが追い出されたり、キャッシュに保持しきれないデータがキャッシュへコピーされたりすることを防ぎます。

値が `0` の場合は、カラムキャッシュの現在のサイズ上限の半分を使用します。サーバーのメモリに余裕がある間は、設定された `columns_cache_size` がその上限となります。ただし、メモリ逼迫時にはキャッシュが縮小し (`ColumnsCacheSizeLimit` メトリクスを参照)、それに伴ってデフォルトの上限値も縮小します。デフォルトの `columns_cache_size_ratio` では、上限の半分がキャッシュの試用 (probationary) セグメントのサイズに相当するため、この判定を通過したクエリのデータは 1 回のパスで完全にキャッシュできます。

この判定は、実行中にマーク範囲を除外する読み取りには適用されません。`use_indexes_refiner_in_read_pools` が有効な場合がこれに該当します。このような読み取りでは、選択されたマークのうち実際にどれだけを参照するかが各タスクの切り出し時点で初めて決まります。そのため、上記の推定値は、クエリが実際には読み取らないマークまで計上した上限値になってしまいます。こうした読み取りでは、代わりに `columns_cache_max_bytes_to_write_to_cache` によって書き込み量が制限されます。