Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

filesystem_cache_* セッション設定

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

filesystem_cache_allow_background_download

Bool
デフォルト値
1
バージョン履歴
バージョンデフォルト値コメント
25.111クエリごとのファイルシステムキャッシュでのバックグラウンドダウンロードを制御するための新しい設定。

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

filesystem_cache_boundary_alignment

UInt64
デフォルト値
0
バージョン履歴
バージョンデフォルト値コメント
24.110新しい設定

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

filesystem_cache_enable_background_download_during_fetch

ClickHouse Cloud 専用
Bool
デフォルト値
1
バージョン履歴
バージョンデフォルト値コメント
24.111新しい設定

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

filesystem_cache_enable_background_download_for_metadata_files_in_packed_storage

ClickHouse Cloud 専用
Bool
デフォルト値
1
バージョン履歴
バージョンデフォルト値コメント
24.111新しい設定

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

filesystem_cache_max_download_size

UInt64
デフォルト値
137438953472

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

filesystem_cache_name

バージョン履歴
バージョンデフォルト値コメント
24.10ステートレスなテーブルエンジンまたはデータレイクで使用するファイルシステムキャッシュの名前

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

filesystem_cache_prefer_bigger_buffer_size

Bool
デフォルト値
1
バージョン履歴
バージョンデフォルト値コメント
24.111新しい設定

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

filesystem_cache_reserve_space_wait_lock_timeout_milliseconds

UInt64
デフォルト値
1000
バージョン履歴
バージョンデフォルト値コメント
24.31000ファイルシステムキャッシュで領域を予約するためにキャッシュをロックするまでの待機時間

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

filesystem_cache_segments_batch_size

UInt64
デフォルト値
20

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

filesystem_cache_skip_download_if_exceeds_per_query_cache_write_limit

別名: skip_download_if_exceeds_query_cache

Bool
デフォルト値
1
バージョン履歴
バージョンデフォルト値コメント
24.111設定 skip_download_if_exceeds_query_cache_limit の名称変更

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

filesystem_cache_verbose_logging

Bool
デフォルト値
0
バージョン履歴
バージョンデフォルト値コメント
26.80ログレベルが許可していれば以前は無条件に出力されていた、ファイルシステムキャッシュの読み取りバッファの再充填ごとのTESTレベルのログメッセージを制御する新しい設定。

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

filesystem_cache_wait_for_concurrent_download_timeout_milliseconds

UInt64
デフォルト値
1000
バージョン履歴
バージョンデフォルト値コメント
26.81000同時実行クエリによってファイルシステムキャッシュにダウンロード中のファイルセグメントを読み取りが待機する時間を制限する新しい設定です。timeout になると、読み取りは無期限に待機せず、cacheをバイパスします。以前の値60000は、従来の動作(ダウンローダーでの完全な60秒間の待機サイクル1回)に相当します。

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

Navigation