map_keys

返回指定 map 中所有键的数组。

此函数从 v2.5 版本开始支持。

语法

map_keys(any_map)

参数

any_map: 您要从中检索键的 MAP 值。

返回值

返回值格式为 array<keyType>。数组中的元素类型与 map 中的键类型匹配。

如果输入为 NULL，则返回 NULL。如果 MAP 值中的键或值为 NULL，则 NULL 将被视为正常值并包含在结果中。

示例

从 StarRocks 本地表查询 MAP 数据

从 v3.1 开始，StarRocks 支持在创建表时定义 MAP 列。此示例使用表 test_map，其中包含以下数据

CREATE TABLE test_map(
    col_int INT,
    col_map MAP<VARCHAR(50),INT>
  )
DUPLICATE KEY(col_int);

INSERT INTO test_map VALUES
(1,map{"a":1,"b":2}),
(2,map{"c":3}),
(3,map{"d":4,"e":5});

SELECT * FROM test_map ORDER BY col_int;
+---------+---------------+
| col_int | col_map       |
+---------+---------------+
|       1 | {"a":1,"b":2} |
|       2 | {"c":3}       |
|       3 | {"d":4,"e":5} |
+---------+---------------+
3 rows in set (0.05 sec)

从 col_map 列的每一行中获取所有键。

select map_keys(col_map) from test_map order by col_int;
+-------------------+
| map_keys(col_map) |
+-------------------+
| ["a","b"]         |
| ["c"]             |
| ["d","e"]         |
+-------------------+
3 rows in set (0.05 sec)

从数据湖查询 MAP 数据

此示例使用 Hive 表 hive_map，其中包含以下数据

SELECT * FROM hive_map ORDER BY col_int;
+---------+---------------+
| col_int | col_map       |
+---------+---------------+
|       1 | {"a":1,"b":2} |
|       2 | {"c":3}       |
|       3 | {"d":4,"e":5} |
+---------+---------------+

在您的集群中创建 Hive catalog 后，您可以使用此 catalog 和 map_keys() 函数从 col_map 列的每一行中获取所有键。

select map_keys(col_map) from hive_map order by col_int;
+-------------------+
| map_keys(col_map) |
+-------------------+
| ["a","b"]         |
| ["c"]             |
| ["d","e"]         |
+-------------------+
3 rows in set (0.05 sec)