跳到主要内容
版本:Stable-3.1

map_filter

功能

根据设定的过滤函数返回 MAP 中匹配的 Key-value 对。该过滤函数可以是普通的 Boolean 数组,也可以是灵活的 Lambda 函数。有关 Lambda 函数的详细信息,参见 Lambda expression

该函数从 3.1 版本开始支持。

语法

MAP map_filter(any_map, array<boolean>)
MAP map_filter(lambda_func, any_map)
  • map_filter(any_map, array<boolean>)

    返回 any_map 中与 array<boolean> 一一对应位置为 true 的 key-value 对。

  • map_filter(lambda_func, any_map)

    返回 any_map 中应用 lambda_func 后值为 true 的 key-value 对。

参数说明

  • any_map: 要进行过滤运算的 MAP 值。

  • array<boolean>: 对 any_map 进行过滤的 Boolean 数组。

  • lambda_func: 对 any_map 进行过滤的 Lambda 函数。

返回值说明

返回 map, 类型与输入的 any_map 相同。

如果 any_map 是 NULL,结果也是 NULL; 如果 array<boolean> 是 null,结果是空 MAP。

如果 Map 中的某个 Key 或 Value 是 NULL,该 NULL 值正常参与计算并返回。

Lambda 函数里必须有两个参数,第一个代表 Key,第二个代表 Value。

示例

不使用 lambda 表达式

以下示例使用 map_from_arrays 生成一个 map 值 {1:"ab",3:"cdd",2:null,null:"abc"}。然后将 array<boolean> 应用到 Map 里的每个 key-value 对,返回为结果 true 的 key-value 对。

mysql> select map_filter(col_map, array<boolean>[0,0,0,1,1]) from (select map_from_arrays([1,3,null,2,null],['ab','cdd',null,null,'abc']) as col_map)A;
+----------------------------------------------------+
| map_filter(col_map, ARRAY<BOOLEAN>[0, 0, 0, 1, 1]) |
+----------------------------------------------------+
| {null:"abc"} |
+----------------------------------------------------+
1 row in set (0.02 sec)

mysql> select map_filter(null, array<boolean>[0,0,0,1,1]);
+-------------------------------------------------+
| map_filter(NULL, ARRAY<BOOLEAN>[0, 0, 0, 1, 1]) |
+-------------------------------------------------+
| NULL |
+-------------------------------------------------+
1 row in set (0.02 sec)

mysql> select map_filter(col_map, null) from (select map_from_arrays([1,3,null,2,null],['ab','cdd',null,null,'abc']) as col_map)A;
+---------------------------+
| map_filter(col_map, NULL) |
+---------------------------+
| {} |
+---------------------------+
1 row in set (0.01 sec)

使用 Lambda 表达式

以下示例使用 map_from_arrays() 生成一个 Map 值 {1:"ab",3:"cdd",2:null,null:"abc"}。然后将 Lambda 函数应用到 Map 中的每个 key-value 对,返回 Value 非 null 的 key-value 对。

mysql> select map_filter((k,v) -> v is not null,col_map) from (select map_from_arrays([1,3,null,2,null],['ab','cdd',null,null,'abc']) as col_map)A;
+------------------------------------------------+
| map_filter((k,v) -> v is not null, col_map) |
+------------------------------------------------+
| {1:"ab",3:"cdd",null:'abc'} |
+------------------------------------------------+
1 row in set (0.02 sec)