Skip to main content

説明

ファイルシステムキャッシュの設定全般に関する情報が含まれています

カラム

  • cache_name (String) — cache名
  • path (String) — cacheディレクトリのパス
  • max_size (UInt64) — cacheの最大サイズ
  • max_elements (UInt64) — cache内の要素の最大数 (例: ファイルセグメント。ファイルシステム上のファイル数を制限)
  • max_file_segment_size (UInt64) — 1つのファイルセグメントの最大サイズ
  • boundary_alignment (UInt64) — ファイルセグメントの境界アラインメント
  • reserve_granularity (UInt64) — ファイルセグメントのダウンロード用に領域を予約する際、ダウンロード済みサイズより少なくともこのバイト数だけ先行して予約します (ファイルセグメントサイズが上限)。粒度を粗くすると、まだダウンロードされていない予約済み領域を保持する代償として (ファイルセグメント完了時に回収)、予約のホットパスでのcache状態ロック取得頻度を低減できます。値を0にすると先行予約を無効化し、要求どおりの領域を予約します。
  • cache_on_write_operations (UInt8) — ライトスルーcacheを有効にします (INSERT 時およびMERGE時にcache)
  • cache_policy (String) — cacheのエビクションポリシー
  • slru_size_ratio (Float64) — SLRU cacheポリシーにおける、保護要素と試用要素のサイズ比率
  • background_download_threads (UInt64) — バックグラウンドダウンロードスレッドの数。値を0にするとバックグラウンドダウンロードを無効化
  • background_download_queue_size_limit (UInt64) — バックグラウンドダウンロードキューのサイズ。値を0にするとバックグラウンドダウンロードを無効化
  • background_download_max_file_segment_size (UInt64) — バックグラウンドダウンロードでダウンロードできる最大サイズ
  • load_metadata_threads (UInt64) — サーバー起動時にcacheメタデータを読み込むために使用するスレッドの最大数
  • load_metadata_asynchronously (UInt8) — サーバー起動時のメタデータの非同期読み込みを有効にします
  • keep_free_space_size_ratio (Float64) — バックグラウンドでcacheが維持しようとする空き容量の比率
  • keep_free_space_elements_ratio (Float64) — バックグラウンドでcacheが維持しようとする空き要素数の比率
  • keep_free_space_remove_batch (UInt64) — 空き容量/空き要素数の比率を維持するバックグラウンドスレッドが実行する、cache要素の削除バッチサイズ
  • keep_free_space_eviction_threads (UInt64) — バックグラウンドでの空き容量/空き要素数比率の維持のために、実際のファイルセグメント削除 (ファイルシステムからの削除) を実行するスレッド数。単一のバックグラウンドスレッドがエビクション候補を収集してその優先度キューエントリを解放し、これらのスレッドがロックなしで並列に削除を実行します
  • invalidated_entries_cleanup_interval_ms (UInt64) — 無効化された (遅延削除される) 優先度キューエントリをパージするバックグラウンドタスクのアイドル間隔 (Milliseconds単位)
  • invalidated_entries_cleanup_threshold (UInt64) — 蓄積された無効化済み優先度キューエントリ数。この値に達するとバックグラウンドでの削除がトリガーされます
  • invalidated_entries_cleanup_remove_batch (UInt64) — バックグラウンド処理の各反復で、1回の書き込みロック中に削除される無効化済み優先度キューエントリの最大数
  • enable_filesystem_query_cache_limit (UInt8) — クエリ内で書き込めるcacheの最大サイズ制限を有効にします
  • cache_hits_threshold (UInt64) — 非推奨の設定
  • enable_bypass_cache_with_threshold (UInt8) — 文書化されていません。使用は推奨されません
  • bypass_cache_threshold (UInt64) — 文書化されていません。使用は推奨されません
  • write_cache_per_user_id_directory (UInt8) — ClickHouse Cloudの内部設定
  • allow_dynamic_cache_resize (UInt8) — ファイルシステムキャッシュの動的なサイズ変更を許可します
  • dynamic_resize_lock_wait_ms (UInt64) — サイズ変更の試行をスキップする前に、動的サイズ変更用の排他ロックの取得を待機するタイムアウト時間 (Milliseconds単位)
  • max_size_ratio_to_total_space (Float64) — 総ディスク容量に対する max_size の比率
  • skip_cache_on_disk_failure (UInt8) — true の場合、ディスク I/O エラー時にファイルシステムキャッシュの操作を暗黙的にスキップします。false の場合 (デフォルト) 、ディスク I/O エラーは起動失敗として伝播されます。
  • use_split_cache (UInt8) — ファイルを system/data 用に分離します。
  • split_cache_ratio (Float64) — split_cache における、キャッシュ総サイズに対する system セグメントの比率
  • system_cache_extensions (String) — use_split_cache が有効な場合に system キャッシュセグメントとして分類されるファイル拡張子のカンマ区切りリスト。この設定を変更しても、既存のキャッシュエントリは以前のセグメントタイプに残り、時間の経過とともに自然にエビクションされます。この設定を変更するには再起動が必要です。
  • overcommit_eviction_evict_step (UInt64) — overcommit エビクションポリシーにおける、バイト単位のエビクションステップです。keep_free_space_*_ratio 設定で使用されます
  • check_cache_probability (Float64) — デバッグまたは sanitizer ビルドでのみ機能します。すべてのキャッシュを走査し、各キャッシュ要素の状態を確認することで、キャッシュの整合性を検証します
  • idle_client_ttl_sec (UInt64) — ゼロ以外で write_cache_per_user_id_directory が有効な場合、この秒数の間アクセスされていないクライアント (user_id) に属するすべてのキャッシュエントリは、キャッシュから完全に削除されます。クライアントによるアクセスのたびにタイマーが更新されます。デフォルトは1週間です。分散キャッシュサーバーで使用されます。
  • idle_client_check_interval_sec (UInt64) — アイドルクライアントのエビクションタスクを実行する間隔 (Seconds単位)。idle_client_ttl_sec がゼロ以外の場合にのみ意味を持ちます。0 は自動値 (max(1, idle_client_ttl_sec / 10)) を意味します。
  • idle_client_eviction_threads (UInt64) — アイドルクライアントのキャッシュをパージするために使用するスレッドの最大数。idle_client_ttl_sec がゼロ以外の場合にのみ意味を持ちます。
  • expose_prometheus_eviction_metrics (UInt8) — ファイルシステムキャッシュのエビクション活動に関する Prometheus メトリクス (filesystem_cache_evictions_total など) を公開します。デフォルトではオフです。SYSTEM RELOAD CONFIG により実行時にトグルできます。
  • expose_prometheus_eviction_metrics_per_user (UInt8) — さらに、ユーザー ID ごとのエビクションメトリクスを公開します。expose_prometheus_eviction_metrics が必要です。カーディナリティは、エビクションを行う個別ユーザー数に応じて増加します。
  • drop_cache_threads (UInt64) — SYSTEM DROP FILESYSTEM CACHE でキャッシュキーを並列に削除するために使用するスレッドの最大数。値が1の場合、削除はクエリスレッドのみで実行されます
  • is_initialized (UInt8) — キャッシュが正常に初期化されたかどうかを示します
  • current_size (UInt64) — 現在のキャッシュサイズ
  • current_elements_num (UInt64) — 現在のキャッシュ要素 (ファイルセグメント) 数
最終更新日 2026年8月14日