sumMapWithOverflow

根据 key 数组中指定的键，对 value 数组求总和。返回一个包含两个数组的元组：排序后的键和对应键的总和值。它与 sumMap 函数的区别在于它执行带溢出的求和 - 即为求和返回与参数数据类型相同的数据类型。

语法

• sumMapWithOverflow(key <Array>, value <Array>) 数组类型。
• sumMapWithOverflow(Tuple(key <Array>, value <Array>)) 元组类型。

参数

• key: 键的 数组。
• value: 值的 数组。

传递键和值数组的元组与分别传递键数组和值数组是同义的。

注意

对于每个被汇总的行，key 和 value 中的元素数量必须相同。

返回值

• 返回一个包含两个数组的元组：排序后的键和对应键的总和值。

示例

首先，我们创建一个名为 sum_map 的表，并将一些数据插入其中。键和值的数组分别存储为名为 statusMap 的 Nested 类型的列，以及一起存储为名为 statusMapTuple 的 tuple 类型的列，以说明上面描述的此函数的两种不同语法的用法。

查询

CREATE TABLE sum_map(
    date Date,
    timeslot DateTime,
    statusMap Nested(
        status UInt8,
        requests UInt8
    ),
    statusMapTuple Tuple(Array(Int8), Array(Int8))
) 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、sumMapWithOverflow 和 toTypeName 函数，那么我们可以看到对于 sumMapWithOverflow 函数，求和值数组的数据类型与参数类型相同，均为 UInt8（即求和操作带有溢出）。对于 sumMap，求和值数组的数据类型已从 UInt8 更改为 UInt64，这样就不会发生溢出。

查询

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

等效地，我们可以使用元组语法获得相同的结果。

SELECT
    timeslot,
    toTypeName(sumMap(statusMapTuple)),
    toTypeName(sumMapWithOverflow(statusMapTuple)),
FROM sum_map
GROUP BY timeslot

结果

   ┌────────────timeslot─┬─toTypeName(sumMap(statusMap.status, statusMap.requests))─┬─toTypeName(sumMapWithOverflow(statusMap.status, statusMap.requests))─┐
1. │ 2000-01-01 00:01:00 │ Tuple(Array(UInt8), Array(UInt64))                       │ Tuple(Array(UInt8), Array(UInt8))                                    │
2. │ 2000-01-01 00:00:00 │ Tuple(Array(UInt8), Array(UInt64))                       │ Tuple(Array(UInt8), Array(UInt8))                                    │
   └─────────────────────┴──────────────────────────────────────────────────────────┴──────────────────────────────────────────────────────────────────────┘

参见

• sumMap