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) — ファイルセグメントの境界アラインメント
  • 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要素の削除バッチサイズ
  • 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) — ファイルシステムキャッシュの動的なサイズ変更を許可します
  • 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 セグメントの比率
  • overcommit_eviction_evict_step (UInt64) — overcommit エビクションポリシーにおける、バイト単位のエビクションステップです。keep_free_space_*_ratio 設定で使用されます
  • check_cache_probability (Float64) — デバッグまたは sanitizer ビルドでのみ機能します。すべてのキャッシュを走査し、各キャッシュ要素の状態を確認することで、キャッシュの整合性を検証します
  • 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 が必要です。カーディナリティは、エビクションを行う個別ユーザー数に応じて増加します。
  • is_initialized (UInt8) — キャッシュが正常に初期化されたかどうかを示します
  • current_size (UInt64) — 現在のキャッシュサイズ
  • current_elements_num (UInt64) — 現在のキャッシュ要素 (ファイルセグメント) 数
最終更新日 2026年7月23日