sumMapWithOverflow

引入版本：v20.1.0 根据 key 数组中指定的键对 value 数组进行汇总。返回一个由两个数组组成的元组：按排序顺序排列的键，以及对应键汇总后的值。它与 sumMap 函数的区别在于，它以溢出方式进行求和——也就是说，求和结果的数据类型与参数的数据类型相同。

传入由键数组和值数组组成的元组，与传入一个键数组和一个值数组是等价的。
对于参与汇总的每一行，key 和 value 中的元素个数必须相同。

语法

sumMapWithOverflow(key, value)
sumMapWithOverflow(Tuple(key, value))

参数

key — 键数组。Array
value — 值数组。Array

返回值 返回一个包含两个数组的元组：按排序后的顺序排列的键，以及对应键的值之和。Tuple(Array, Array) 示例 演示溢出行为的 Array 语法

Query

CREATE TABLE sum_map(
    date Date,
    timeslot DateTime,
    statusMap Nested(
        status UInt8,
        requests UInt8
    ),
    statusMapTuple Tuple(Array(Int8), Array(Int8))
) ENGINE = Memory;

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

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

Response

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

使用 Tuple 语法可得到相同结果

Query

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

Response

┌────────────timeslot─┬─toTypeName(sumMap(statusMapTuple))─┬─toTypeName(sumMapWithOverflow(statusMapTuple))─┐
│ 2000-01-01 00:00:00 │ Tuple(Array(Int8), Array(Int64))   │ Tuple(Array(Int8), Array(Int8))                │
│ 2000-01-01 00:01:00 │ Tuple(Array(Int8), Array(Int64))   │ Tuple(Array(Int8), Array(Int8))                │
└─────────────────────┴────────────────────────────────────┴────────────────────────────────────────────────┘

另请参阅

sumMap

SQL 参考文档

数据类型

引擎

函数

格式

设置

系统表

数据湖

sumMapWithOverflow

sumMapWithOverflow

​sumMapWithOverflow

sumMapWithOverflow