aggregate_* セッション設定

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

aggregate_function_input_format

入力フォーマットが AggregateFunction 型のカラムをどのように読み取るかを指定します。設定可能な値:

state — 出力フォーマットが書き出すのと同じ、集約関数のシリアル化された状態 (デフォルト) 。
value — 集約関数の引数の値、または引数が複数ある場合はそれらのタプル。値は集約され、状態が構成されます。
array — 上記の value オプションで説明した値の配列。配列のすべての要素が集約され、状態が構成されます。

value モードおよび array モードでは、フォーマットは対象のカラムを値の型として読み取ります。すなわち、AggregateFunction(f, T) の場合は T、AggregateFunction(f, T1, T2) の場合は Tuple(T1, T2)、array モードではそれらの Array として扱われます。値は、そのフォーマットが当該の型に用いる表現で書き込まれます。テキストフォーマットでは数値または文字列、JSON フォーマットでは JSON配列、RowBinary や Native ではその型のバイナリエンコーディング、Parquet ではその型のカラム、といった形です。これはすべての入力フォーマットに適用され、Array、Tuple、Map 内にネストされた AggregateFunction にも適用されます。例次の構造を持つテーブルの場合:

CREATE TABLE example (
    user_id UInt64,
    avg_session_length AggregateFunction(avg, UInt32)
);

aggregate_function_input_format = 'value' の場合:

INSERT INTO example FORMAT CSV
123,456

INSERT INTO example FORMAT JSONEachRow
{"user_id": 123, "avg_session_length": 456}

aggregate_function_input_format = 'array' の場合:

INSERT INTO example FORMAT CSV
123,"[456,789,101]"

INSERT INTO example FORMAT JSONEachRow
{"user_id": 123, "avg_session_length": [456, 789, 101]}

注意: value および array フォーマットは、挿入時に値の生成と集約を行う必要があるため、デフォルトの state フォーマットよりも低速です。

aggregate_functions_null_for_empty

クエリ内のすべての集約関数を -OrNull 接尾辞付きに書き換える機能を有効または無効にします。SQL標準互換性のために有効にしてください。これは、一貫した結果を分散クエリで得るために、クエリの書き換え (count_distinct_implementation 設定と同様) によって実装されています。設定可能な値:

0 — 無効。
1 — 有効。

例次の集約関数を含むクエリを考えてみましょう:

SELECT SUM(-1), MAX(0) FROM system.one WHERE 0;

aggregate_functions_null_for_empty = 0 の場合、次のような結果が得られます。

┌─SUM(-1)─┬─MAX(0)─┐
│       0 │      0 │
└─────────┴────────┘

aggregate_functions_null_for_empty = 1 を 1 にすると、結果は次のようになります:

┌─SUMOrNull(-1)─┬─MAXOrNull(0)─┐
│          NULL │         NULL │
└───────────────┴──────────────┘

SQLリファレンス

データ型

エンジン

関数

フォーマット

設定

システムテーブル

データレイク

aggregate_function_input_format

aggregate_functions_null_for_empty

​aggregate_function_input_format

​aggregate_functions_null_for_empty

aggregate_function_input_format

aggregate_functions_null_for_empty