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

filesystem_cache_allow_background_download

リモートストレージから読み取ったデータについて、ファイルシステムキャッシュがバックグラウンドダウンロードをキューに追加できるようにします。無効にすると、現在のクエリ/セッションではダウンロードはフォアグラウンドで実行されます。

filesystem_cache_boundary_alignment

ファイルシステムキャッシュの境界アラインメント。この設定は、ディスク以外からの読み取りにのみ適用されます (たとえば、リモートテーブルエンジン / テーブル関数の cache には適用されますが、MergeTree テーブルのストレージ構成には適用されません) 。値が 0 の場合、アラインメントは行われません。

filesystem_cache_enable_background_download_during_fetch

ClickHouse Cloud でのみ有効です。ファイルシステムキャッシュで領域を予約するためにcacheをロックするまでの待機時間

filesystem_cache_enable_background_download_for_metadata_files_in_packed_storage

ClickHouse Cloud でのみ有効です。ファイルシステムキャッシュ内の領域を予約するためにキャッシュをロックするまでの待機時間

filesystem_cache_max_download_size

1 回のクエリでダウンロードできるリモートファイルシステムキャッシュの最大サイズ

filesystem_cache_name

ステートレスなテーブルエンジンまたはデータレイクで使用するファイルシステムキャッシュの名前

filesystem_cache_prefer_bigger_buffer_size

ファイルシステムキャッシュが有効な場合、cache のパフォーマンスを低下させる小さなファイルセグメントの書き込みを避けるため、より大きなバッファサイズを優先します。一方、この設定を有効にすると、メモリ使用量が増える可能性があります。

filesystem_cache_reserve_space_wait_lock_timeout_milliseconds

ファイルシステムキャッシュで領域を予約するためにキャッシュをロックするまでの待機時間

filesystem_cache_segments_batch_size

読み取りバッファが cache から 1 回のバッチでリクエストできるファイルセグメント数の上限です。値が低すぎると cache へのリクエストが過剰になり、値が大きすぎると cache からのエビクションが遅くなる可能性があります

filesystem_cache_skip_download_if_exceeds_per_query_cache_write_limit

別名: skip_download_if_exceeds_query_cache クエリキャッシュのサイズ制限を超える場合、リモートファイルシステムからのダウンロードをスキップします

filesystem_cache_verbose_logging

ファイルシステムキャッシュのバッファ再充填ごとに、TEST レベルのログメッセージ (読み取りの状態、残りの読み取りサイズ、読み取ったバイト数) を出力します。デバッグ専用です。メッセージは読み取りごとに一度整形されるため、多数の小さなキャッシュ済み読み取りを行うクエリで有効にすると、大きなロギングオーバーヘッドが発生します。メッセージが表示されるのは、いずれにしてもログレベルが test の場合のみです (send_logs_level を参照) 。

filesystem_cache_wait_for_concurrent_download_timeout_milliseconds

同時実行クエリによってファイルシステムキャッシュにダウンロード中のファイルセグメントを待機する最大時間です。timeout に達すると、読み取りはその範囲ではファイルシステムキャッシュをバイパスし、リモートストレージから直接読み取ります。同時実行ダウンロードはその間もcacheの充填を続けます。値0は、まったく待機しないことを意味します。必要な範囲がまだダウンロードされていない場合は、直ちにcacheをバイパスします。この値を小さくすると、リモートストレージへの追加リクエストが増える代わりに、別のクエリのダウンロード速度を待機する可能性があるcacheヒット読み取りのtail latencyを抑えられます。
最終更新日 2026年8月14日