sumMap

key 配列で指定されたキーに従って、1 つ以上の value 配列を合計します。返り値は配列のタプルであり、ソート済みの順序で並んだキーの配列に続いて、対応するキーごとにオーバーフローなしで合計された値の配列が続きます。

構文

sumMap(key <Array>, value1 <Array>[, value2 <Array>, ...]) Array 型。
sumMap(Tuple(key <Array>[, value1 <Array>, value2 <Array>, ...])) Tuple 型。

別名: sumMappedArrays。

引数

key: キーの Array。
value1, value2, ...: 各キーごとに合計する値の Array。

キー配列と値配列のタプルを渡すことは、キーの配列と値の配列を個別に渡すことと同義です。

注記

合計される各行について、key とすべての value 配列の要素数は同じでなければなりません。

返り値

配列のタプルを返します。最初の配列にはソート済みのキーが含まれ、その後に対応するキーごとに合計された値を含む配列が続きます。

例

はじめに sum_map というテーブルを作成し、そこにデータを挿入します。キーと値の配列は Nested 型の statusMap というカラムとして個別に保存される一方で、上で説明したこの関数の 2 つの異なる構文の使い方を示すために、tuple 型の statusMapTuple というカラムとしてまとめて保存されます。

クエリ:

CREATE TABLE sum_map(
    date Date,
    timeslot DateTime,
    statusMap Nested(
        status UInt16,
        requests UInt64
    ),
    statusMapTuple Tuple(Array(Int32), Array(Int32))
) ENGINE = Log;

INSERT INTO sum_map VALUES
    ('2000-01-01', '2000-01-01 00:00:00', [1, 2, 3], [10, 10, 10], ([1, 2, 3], [10, 10, 10])),
    ('2000-01-01', '2000-01-01 00:00:00', [3, 4, 5], [10, 10, 10], ([3, 4, 5], [10, 10, 10])),
    ('2000-01-01', '2000-01-01 00:01:00', [4, 5, 6], [10, 10, 10], ([4, 5, 6], [10, 10, 10])),
    ('2000-01-01', '2000-01-01 00:01:00', [6, 7, 8], [10, 10, 10], ([6, 7, 8], [10, 10, 10]));

次に、配列型とタプル型の両方の構文を用いて、sumMap 関数でテーブルをクエリします。

クエリ:

SELECT
    timeslot,
    sumMap(statusMap.status, statusMap.requests),
    sumMap(statusMapTuple)
FROM sum_map
GROUP BY timeslot

結果：

┌────────────timeslot─┬─sumMap(statusMap.status, statusMap.requests)─┬─sumMap(statusMapTuple)─────────┐
│ 2000-01-01 00:00:00 │ ([1,2,3,4,5],[10,10,20,10,10])               │ ([1,2,3,4,5],[10,10,20,10,10]) │
│ 2000-01-01 00:01:00 │ ([4,5,6,7,8],[10,10,20,10,10])               │ ([4,5,6,7,8],[10,10,20,10,10]) │
└─────────────────────┴──────────────────────────────────────────────┴────────────────────────────────┘

複数の値の配列を扱う例

sumMap は、複数の値の配列を同時に集約することもサポートしています。これは、同じキーを共有する関連メトリクスがある場合に便利です。

CREATE TABLE multi_metrics(
    date Date,
    browser_metrics Nested(
        browser String,
        impressions UInt32,
        clicks UInt32
    )
)
ENGINE = MergeTree()
ORDER BY tuple();

INSERT INTO multi_metrics VALUES
    ('2000-01-01', ['Firefox', 'Chrome'], [100, 200], [10, 25]),
    ('2000-01-01', ['Chrome', 'Safari'], [150, 50], [20, 5]),
    ('2000-01-01', ['Firefox', 'Edge'], [80, 40], [8, 4]);

SELECT 
    sumMap(browser_metrics.browser, browser_metrics.impressions, browser_metrics.clicks) AS result
FROM multi_metrics;

┌─result────────────────────────────────────────────────────────────────────────┐
│ (['Chrome', 'Edge', 'Firefox', 'Safari'], [350, 40, 180, 50], [45, 4, 18, 5]) │
└───────────────────────────────────────────────────────────────────────────────┘

この例では、

結果タプルには 3 つの配列が含まれます
1 つ目の配列: ソート済みのキー（ブラウザ名）
2 つ目の配列: 各ブラウザの合計インプレッション数
3 つ目の配列: 各ブラウザの合計クリック数

関連項目