これらの設定は system.merge_tree_settings で利用でき、ClickHouseのソースコードから自動生成されています。
number_of_free_entries_in_pool_to_execute_mutation
プール内の空きエントリ数が指定した数未満の場合、 part mutation は実行されません。これは、通常のマージ用の空きスレッドを確保し、 「パーツが多すぎる」エラーを回避するためです。
設定可能な値:
- 任意の正の整数。
使用方法
number_of_free_entries_in_pool_to_execute_mutation 設定の値は、
background_pool_size
と background_merges_mutations_concurrency_ratio の積を超えてはなりません。
そうしないと、ClickHouse は例外をスローします。
number_of_free_entries_in_pool_to_execute_optimize_entire_partition
プール内の空きエントリ数が指定した数を下回る場合、バックグラウンドでパーティション全体の最適化は実行されません (このタスクは
min_age_to_force_merge_seconds を設定し、
min_age_to_force_merge_on_partition_only を有効にすると生成されます) 。これは、通常のマージ用の空きスレッドを確保し、
「パーツが多すぎる」を回避するためです。
設定可能な値:
- 正の整数。
number_of_free_entries_in_pool_to_execute_optimize_entire_partition
設定の値は、
background_pool_size
- background_merges_mutations_concurrency_ratio の値より小さくする必要があります。 そうでない場合、ClickHouse は例外をスローします。
number_of_free_entries_in_pool_to_lower_max_size_of_merge
プール 内の空きエントリ数 (または replicated queue 内の空きエントリ数) が指定値を下回ると、 処理する マージ の最大サイズ (または queue に入れる マージ の最大サイズ) を引き下げ始めます。 これは、小規模な マージ を処理できるようにし、長時間実行される マージ で プール が埋まるのを防ぐためです。
設定可能な値:
- 任意の正の整数。
number_of_mutations_to_delay
テーブルに少なくとも この数の未完了の mutation がある場合、テーブルの mutation を意図的に遅くします。 0 に設定すると無効になります
number_of_mutations_to_throw
table に少なくともこの数の未完了の mutation がある場合、'Too many mutations' 例外をスローします。0 に設定すると無効になります
number_of_partitions_to_consider_for_merge
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.1 | 10 | Cloud sync |
ClickHouse Cloud でのみ利用できます。マージ対象として考慮されるパーティションの最大数です。パーティションは重み付きでランダムに選択され、この重みはそのパーティション内でマージ可能なデータパーツ数に基づきます。