これらの設定は system.merge_tree_settings で参照でき、ClickHouse のソースから自動生成されています。
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.9 | 0 | 新しい設定 |
| 25.8 | 0 | 新しい設定 |
| 25.7 | 0 | 新しい設定 |
| 25.6 | 0 | 新しい設定 |
| 25.10 | 0 | 新しい設定 |
協調マージタスクの再スケジューリングを有効にします。これは、 shared_merge_tree_enable_coordinated_merges=0 の場合でも、マージコーディネーターの 統計情報が蓄積され、コールドスタートに役立つため有用です。
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 26.9 | 0 | blob-list パーツ内の小さなファイルを個別のブロブではなく統合された blobs.list にインラインで格納する新しい設定 |
指定したバイト数以下の blob-list パーツ内のファイル (例: count.txt、metadata_version.txt、minmax 索引) を、個別のオブジェクトストレージブロブではなく 統合された blobs.list ファイルに直接格納します。これにより、小さなファイルごとにブロブの書き込みと読み取りを1回ずつ削減できます。0 を指定するとインライン化は無効になります。 blob-list ストレージを使用するパーツにのみ適用されます ( shared_merge_tree_use_blobs_list_for_parts を参照) 。ClickHouse Cloud でのみ利用できます。
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.11 | 0 | Keeper 内のメタデータ量を削減します。 |
| 25.1 | 1 | Cloud sync |
ZooKeeper で、レプリカごとの /metadata ノードと /columns ノードを作成できるようにします。 ClickHouse Cloud でのみ利用できます
shared merge tree のマージ割り当てを停止します。ClickHouse Cloud でのみ使用できます
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.9 | 86400 | 新しい設定 |
パーツがないパーティションをKeeperに保持する秒数。
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 26.2 | 1 | デフォルトで有効 |
| 25.9 | 0 | 新しい設定 |
空のパーティションに対応する Keeper エントリのクリーンアップを有効にします。
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 26.6 | 1 | デフォルトで 協調マージ を有効化 |
| 25.5 | 0 | 新しい設定 |
協調マージ 戦略を有効化します
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 26.6 | 1 | デフォルトで 協調マージ を有効にする |
| 25.3 | 0 | 新しい設定 |
仮想パーツへの属性の書き込みと、Keeper でのブロックのコミットを有効にします
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.1 | 1 | Cloud sync |
古くなったパーツのチェックを有効にします。ClickHouse Cloud でのみ利用できます
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.1 | 3600 | Cloud sync |
shared merge tree で、ZooKeeper の watch によるトリガーなしでパーツを更新する間隔 (秒) です。ClickHouse Cloud でのみ利用できます
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 26.6 | 0 | 非アクティブなレプリカをバックグラウンドクリーンアップでどれくらいの間考慮するかを制御する新しい設定(0 は ZooKeeper のセッションタイムアウト 2 回分を意味します) |
非アクティブなレプリカがバックグラウンドクリーンアップ
(OutdatedPartsQuorumThread) で引き続き考慮される期間を指定します。レプリカの非アクティブ時間がこの秒数未満である間は、
そのレプリカによって古くなったパーツの削除と完了したミューテーションの切り捨てが保留されます。値が 0 の場合は、
デフォルトの ZooKeeper のセッションタイムアウト 2 回分が使用されます。
ClickHouse Cloud でのみ使用できます
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.2 | 50 | 新しい設定 |
パーツ更新時の初期バックオフ。ClickHouse Cloud でのみ利用可能
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.2 | 100 | 新しい設定 |
サーバー間のHTTP接続のタイムアウト。ClickHouse Cloud でのみ利用できます
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.1 | 10000 | Cloud sync |
サーバー間 HTTP 通信のタイムアウトです。ClickHouse Cloud でのみ利用できます
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.1 | 10 | Cloud sync |
サンダリングハード現象を回避するため、 0〜x秒の範囲で一様分布する値を shared_merge_tree_leader_update_period に加算します。ClickHouse Cloud でのみ利用できます
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.1 | 30 | Cloud sync |
パーツ更新におけるリーダーシップを再確認する最大周期。利用できるのは ClickHouse Cloud のみです。
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.1 | 1000 | Cloud sync |
リーダーが1回のHTTPリクエストで削除対象として確認を試みる、古くなったパーツの最大数です。ClickHouse Cloudでのみ利用できます。
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.2 | 5000 | 新しい設定 |
パーツ更新の最大バックオフ時間。ClickHouse Cloud でのみ利用可能
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.1 | 6 | Cloud sync |
パーツ更新リーダーの最大数。ClickHouse Cloudでのみ利用できます
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.1 | 2 | Cloud sync |
パーツ更新リーダーの最大数。ClickHouse Cloud でのみ利用可能
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.1 | 10 | Cloud sync |
パーツ削除 (キラースレッド) に参加するレプリカの最大数です。ClickHouse Cloud でのみ利用できます
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.1 | 5 | Cloud sync |
競合する可能性のあるマージの割り当てを試行するレプリカの最大数です (これにより、マージ割り当て時の不要な競合を回避できます) 。0 は無効を意味します。ClickHouse Cloud でのみ使用できます
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.2 | 0 | SMT の破損したパーツの最大数。これを超えると、自動デタッチは行われません |
SMT の破損したパーツの最大数。これを超えると、自動デタッチは行われません。
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.2 | 0 | SMT におけるすべての破損パーツの合計サイズの上限。この値を超えると、自動デタッチは許可されません |
SMT におけるすべての破損パーツの合計サイズの上限。この値を超えると、自動デタッチは許可されません。
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.1 | 1800 | Cloud sync |
insert の再試行中に誤った操作を防ぐため、insert のメモ化 ID を保持する期間です。 ClickHouse Cloud でのみ利用できます
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 26.8 | sainte_lague | デフォルトでSainte-Lague分散を有効にする。 |
| 26.7 | water_filling | マージコーディネーターがレプリカ間でマージを分散する際に使用するアルゴリズムを制御する新しい設定 |
マージコーディネータースレッドが、レプリカ間でマージを分散する際に使用するアルゴリズム。
設定可能な値:
water_fillingsainte_lague
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.5 | 30000 | 新しい設定 |
マージコーディネーター選出スレッドの実行間隔
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.5 | 1.100000023841858 | 新しい設定 |
| 25.10 | 1.100000023841858 | 負荷後のマージコーディネーターのスリープ時間を短縮 |
コーディネータースレッドの遅延時間を変更する係数
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.5 | 10000 | 新しい設定 |
マージコーディネーターが最新のメタデータを取得するためにZooKeeperと同期する頻度
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.5 | 20 | 新しい設定 |
マージコーディネーターが一度に MergerMutator にリクエストできるマージ数
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.5 | 10000 | 新しい設定 |
マージコーディネータースレッドの実行間の最大間隔
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 26.4 | auto | 設定を auto にする: レプリカごとの最大マージタスク数 × アクティブなレプリカ数 |
| 25.5 | 100 | 新しい設定 |
マージコーディネーターが準備し、各ワーカーに分配するマージエントリの数。 'auto' に設定すると、1 つのレプリカで許可される最大マージタスク数に、アクティブなレプリカ数を掛けた値になります。
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.5 | 1 | 新しい設定 |
マージコーディネータースレッドの実行間の最小時間
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.5 | 100 | 新しい設定 |
即時アクション後に状態を更新する必要がある場合に、マージワーカースレッドが使用するタイムアウト
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.5 | 10000 | 新しい設定 |
マージワーカースレッドの実行間隔
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.9 | 2 | 新しい設定 |
古くなったパーツ のクリーンアップ時に、同じランデブーハッシュグループに属するレプリカ数。 ClickHouse Cloud でのみ利用できます。
<candidate partitions for mutations only (partitions that cannot be merged)>/<candidate partitions for mutations> の比率がこの設定値を上回ると、merge/mutate の選択タスクで merge predicate を再読み込みします。ClickHouse Cloud
でのみ利用できます
一度にスケジュールする、フェッチするパーツのメタデータジョブ数。利用できるのは ClickHouse Cloud のみです。
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.1 | 0 | Cloud sync |
ローカルでマージされたパーツを含む新たなマージを開始せずに、そのパーツを保持しておく時間です。 これにより、他のレプリカがそのパーツをフェッチし、このマージを開始する機会を確保できます。 ClickHouse Cloud でのみ利用できます。
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.1 | 1000000 | Cloud sync |
ローカルでマージした直後に次のマージの割り当てを延期するための、パーツの最小サイズ (行数) です。ClickHouse Cloud でのみ利用できます。
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.1 | 10 | Cloud sync |
レプリカ間でマージ割り当てを分散する際に使用するウィンドウサイズ (block番号単位) 。 同じウィンドウ内のパーツは同じレプリカに割り当てられます。 ClickHouse Cloud でのみ利用できます
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.1 | 1 | Cloud sync |
可能な場合はリーダーから仮想パーツを読み取ります。ClickHouse Cloudでのみ利用できます。
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 26.4 | 1800 | レプリカセットのバックグラウンド更新のデフォルト間隔を30分に延長 |
| 26.2 | 300 | 新しい設定 |
レプリカがバックグラウンドでレプリカセットの更新を試みる頻度です。次回の実行は [0, value] 秒の範囲で 一様にランダム化されます。例外: value = 0 はこのルールに従いません。 実装では最小 200 ms が適用されるため、次回の実行は [0, 200] ms の範囲でランダム化されます。
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.1 | 0 | 他のレプリカからパーツのメモリ内データを取得するための新しい設定 |
有効にすると、すべてのレプリカは、すでにそのデータを保持している他のレプリカから、パーツのメモリ内データ (プライマリキー、パーティション情報など) を取得しようとします。
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 26.6 | 0 | 起動時に、SMT が S3 ではなくレプリカからパーツデータをダウンロードできるようにする新しい設定 |
有効にすると、すべてのレプリカは起動時に、すでにそのデータを保持している他のレプリカから、パーツのメモリ内データ (主キー、パーティション情報など) を取得しようとします。
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.8 | 30000 | 新しい設定 |
レプリカがバックグラウンドスケジュールに従ってフラグの再読み込みを試行する間隔。
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 26.9 | 0 | SharedMergeTree パーツのファイルごとのブロブマップを、ファイルごとに 1 つのノードではなく、1 つに集約した Keeper ノードに保存する新しい設定 |
SharedMergeTree テーブルのパーツ (wide パーツと compact パーツの両方) を、ファイルごとに 1 つの Keeper ノードではなく、単一の集約された blob-list のメタデータノードとして保存します。 ファイルごとに 1 つのオブジェクトストレージブロブを維持しながら、パーツごとの Keeper メタデータを O(ファイル数) から小さな定数に削減します。ClickHouse Cloud でのみ利用できます。
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.1 | 1 | Cloud sync |
他のレプリカ上のインメモリ cacheからFS cacheヒントをリクエストできるようにします。ClickHouse Cloudでのみ利用できます
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.9 | 1 | 既定で outdated パーツ v3 を有効化 |
| 25.1 | 0 | Cloud sync |
outdated パーツには compact フォーマットを使用します。これにより Keeper への負荷が軽減され、 outdated パーツの処理が改善されます。ClickHouse Cloud でのみ利用可能です
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.1 | 0 | Cloud sync |
有効にすると、パーツが多すぎるカウンターはローカルレプリカの状態ではなく、Keeper 内の shared data を参照します。ClickHouse Cloud でのみ利用できます
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 26.3 | 0 | 新しい設定 |
有効にすると、SharedMergeTree はサーバーレベルのプールされた ZooKeeper セッションのいずれかを使用します。
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 25.8 | 1 | 新しい設定 |
1つのバッチにまとめるパーティション検出の数
バージョン履歴
| バージョン | デフォルト値 | コメント |
|---|---|---|
| 26.7 | 1 | 新しい設定 |
廃止された設定であり、何の効果もありません。