メインコンテンツまでスキップ
メインコンテンツまでスキップ

sumMap

key 配列で指定されたキーに従って、value 配列の合計を算出します。ソートされた順序でのキーと、対応するキーの合計値の二つの配列からなるタプルを返します。

構文

  • sumMap(key <Array>, value <Array>) Array type
  • sumMap(Tuple(key <Array>, value <Array>)) Tuple type

別名: sumMappedArrays

引数

  • key: Array 型のキーの配列。
  • value: Array 型の値の配列。

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

注記

keyvalue の要素数は、合計を算出する各行で同じでなければなりません。

返される値

  • ソートされた順序のキーと、対応するキーの合計値からなる二つの配列のタプルを返します。

まず、sum_map というテーブルを作成し、いくつかのデータを挿入します。キーと値の配列は、Nested 型のカラム statusMap と、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]) │
└─────────────────────┴──────────────────────────────────────────────┴────────────────────────────────┘

関連情報