Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

page_cache_* セッション設定

これらの設定は system.settings で確認でき、ソースコード から自動生成されています。

page_cache_block_size

UInt64
デフォルト値
1048576
バージョン履歴
バージョンデフォルト値コメント
25.51048576この設定をクエリ単位で調整できるようにしました。

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

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

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

page_cache_inject_eviction

Bool
デフォルト値
0
バージョン履歴
バージョンデフォルト値コメント
24.30ユーザー空間ページキャッシュを追加

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

page_cache_lookahead_blocks

UInt64
デフォルト値
16
バージョン履歴
バージョンデフォルト値コメント
25.516この設定をクエリ単位で調整できるようにしました。

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

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

page_cache_max_coalesced_bytes

UInt64
デフォルト値
16777216
バージョン履歴
バージョンデフォルト値コメント
26.516777216キャッシュミス時にユーザー空間ページキャッシュを拡充するために使用される、単一の結合読み取りサイズを制限する新しい設定。

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

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

Navigation