SummingMergeTree
このエンジンは MergeTree から継承されています。違いは、SummingMergeTree テーブルのデータパーツをマージする際に、ClickHouse が同じ主キーのすべての行（より正確には、同じ ソートキー）を持つ行を、数値データ型のカラムの合計値を持つ1行に置き換える点です。ソートキーが単一のキー値に大きな数の行が対応するように構成されている場合、これによりストレージボリュームが大幅に削減され、データ選択が迅速になります。
エンジンは MergeTree と共に使用することをお勧めします。すべてのデータを MergeTree テーブルに保存し、集計データを保存するために SummingMergeTree を使用します。たとえば、レポートを作成するときです。このアプローチにより、誤って構成された主キーによる貴重なデータ損失を防ぐことができます。
テーブルの作成
リクエストパラメータの説明については、リクエストの説明を参照してください。
SummingMergeTree のパラメータ
columns
columns - 値が合計されるカラムの名前のタプル。オプションのパラメータです。
カラムは数値型でなければならず、パーティションまたはソートキーに含まれてはいけません。
columns が指定されない場合、ClickHouse はソートキーに含まれないすべての数値データ型のカラムの値を合計します。
クエリ句
SummingMergeTree テーブルを作成する際には、MergeTree テーブルを作成する時と同じ 句 が必要です。
テーブルを作成するための非推奨メソッド
このメソッドは新しいプロジェクトでは使用しないでください。可能であれば、古いプロジェクトを上記に記載した方法に切り替えてください。
すべてのパラメータは MergeTree での意味と同じです。
columns- 合計されるカラムの名前のタプル。オプションのパラメータです。詳細は上記のテキストを参照してください。
使用例
次のテーブルを考えてみましょう。
データを挿入します。
ClickHouse はすべての行を完全に合計しない場合があります（下記参照）。そのため、クエリ内で集計関数 sum と GROUP BY 句を使用します。
データ処理
データがテーブルに挿入されると、それらはそのまま保存されます。ClickHouse は挿入されたデータパーツを定期的にマージし、この際に同じ主キーを持つ行が合計され、それぞれのデータパーツごとに1つに置き換えられます。
ClickHouse はデータパーツをマージできるため、異なる結果のデータパーツが同じ主キーを持つ行で構成されることがあります。すなわち、合計が不完全になる可能性があります。そのため、クエリ内で集計関数 sum() と GROUP BY 句を使用する必要があります。上記の例のように。
合計に関する一般規則
数値データ型のカラムの値が合計されます。カラムのセットは columns パラメータによって定義されます。
合計のためのカラムのすべての値が 0 である場合、その行は削除されます。
カラムが主キーに含まれておらず、合計されない場合、既存の値から任意の値が選択されます。
主キーのカラムについては、値は合計されません。
集約関数カラムでの合計
AggregateFunction 型 のカラムについて、ClickHouse はその関数に従って集約する AggregatingMergeTree エンジンのように動作します。
ネストされた構造
テーブルは特別な方法で処理されるネストされたデータ構造を持つことができます。
ネストされたテーブルの名前が Map で終わり、少なくとも次の条件を満たす2カラム以上を含む場合：
- 最初のカラムは数値型
(*Int*, Date, DateTime)または文字列(String, FixedString)で、これをkeyと呼びます。 - 他のカラムは算術型
(*Int*, Float32/64)で、これを(values...)と呼びます。
このネストされたテーブルは key => (values...) のマッピングとして解釈され、行をマージするときに、2つのデータセットの要素が key によってマージされ、対応する (values...) の合計が計算されます。
例：
データを要求する際には、Map の集計には sumMap(key, value) 関数を使用します。
ネストされたデータ構造では、合計のためのカラムのタプルにそのカラムを指定する必要はありません。
