Todos os produtos
Search
Central de documentação

MaxCompute:MAP_KEYS

Última atualização: Sep 22, 2026

Retorna todas as chaves do Map a como um array.

Sintaxe

array<K> map_keys(map<K, V> <a>)

Parâmetros

a: obrigatório. Especifica um map. K e V em map<K, V> representam as chaves e os valores de um map.

Valor de retorno

Retorna um valor do tipo ARRAY. Se o map de entrada for null, o retorno será null.

Exemplos

Retorne todas as chaves de um map com base nos dados da tabela t_table_map, que contém as colunas c1 (BIGINT) and t_map (MAP<STRING,BIGINT>). Dados da tabela:

+------------+-------+
| c1         | t_map |
+------------+-------+
| 1000       | {k11:86, k21:15} |
| 1001       | {k12:97, k22:2} |
| 1002       | {k13:99, k23:1} |
+------------+-------+

Instrução de exemplo:

-- Return keys in the t_map column as an array. 
select c1, map_keys(t_map) from t_table_map;
-- The following result is returned: 
+------------+------+
| c1         | _c1  |
+------------+------+
| 1000       | [k11, k21] |
| 1001       | [k12, k22] |
| 1002       | [k13, k23] |
+------------+------+

Funções relacionadas

MAP_KEYS é uma função de tipo complexo. Para obter mais informações sobre as funções usadas para processar dados de tipos complexos, como ARRAY, MAP, STRUCT e JSON, consulte Complex type functions.