Tous les produits
Search
Centre de documentation

MaxCompute:MAP_KEYS

Dernière mise à jour :Sep 22, 2026

Renvoie toutes les clés d'une map a sous forme de tableau.

Syntaxe

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

Paramètres

a : obligatoire. Spécifie une map. Les paramètres K et V dans map<K, V> définissent respectivement les clés et les valeurs de la map.

Valeur de retour

Renvoie une valeur de type ARRAY. Si la map en entrée est nulle, la fonction renvoie null.

Exemples

L'exemple suivant renvoie toutes les clés d'une map à partir des données de la table t_table_map qui contient les colonnes c1 (BIGINT) and t_map (MAP<STRING,BIGINT>). Données de la table :

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

Exemple d'instruction :

-- 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] |
+------------+------+

Fonctions associées

MAP_KEYS est une fonction de type complexe. Pour plus d'informations sur les fonctions de traitement des types complexes (ARRAY, MAP, STRUCT et JSON), consultez la section Fonctions de type complexe.