大网数据广告活动
数据库部署与 SQL 参考

StarRocks 中文参考:map_filter

· 52CE 我爱测

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

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)

本文来自 StarRocks 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
StarRocks 文档贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。