跳至主要内容

sumMapWithOverflow

根据 key 数组中指定的键对 value 数组进行求和。返回两个数组的元组:按排序顺序排列的键,以及对应键的求和值。它与 sumMap 函数的不同之处在于,它进行带有溢出的求和 - 也就是说,对求和返回与参数数据类型相同的数据类型。

语法

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

参数

传递键和值数组的元组等同于分别传递键数组和值数组。

注意

对于要汇总的每一行,keyvalue 中的元素数量必须相同。

返回值

  • 返回两个数组的元组:按排序顺序排列的键,以及对应键的求和值。

示例

首先,我们创建一个名为 sum_map 的表,并向其中插入一些数据。键和值的数组分别存储为名为 statusMap嵌套 类型列,以及作为名为 statusMapTuple元组 类型列,以说明上面描述的此函数两种不同语法的使用方式。

查询

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]));

如果我们使用 sumMapsumMapWithOverflow(数组类型语法)和 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)) │
└─────────────────────┴──────────────────────────────────────────────────────────┴──────────────────────────────────────────────────────────────────────┘

另请参阅