Tous les produits
Search
Centre de documentation

MaxCompute:MULTIMAP_FROM_ENTRIES

Dernière mise à jour :Aug 10, 2026

Renvoie une map constituée des clés issues d'un tableau de structures et des tableaux contenant toutes les valeurs associées.

Syntaxe

	multimap_from_entries(array<struct<K, V>>)

Paramètres

array<struct<K, V>> : tableau de structures composé de paires clé/valeur.

Valeur de retour

La fonction renvoie une map au format map<K, array<V>>. Cette map est construite à partir des clés du tableau de structures et des tableaux regroupant l'ensemble des valeurs correspondantes.

  • Chaque clé de la map renvoyée peut être associée à plusieurs valeurs, stockées dans un tableau.

  • Si le tableau en entrée est Null, la valeur de retour est Null.

  • Une exception est levée si le nombre de champs (StructField) dans la structure n'est pas égal à 2 ou si une clé contient une valeur Null.

Exemples

SELECT multimap_from_entries(array(struct(1, 'a'), 
                                     struct(2, 'b'), 
                                     struct(1, 'c')));

Le résultat renvoyé est le suivant :

{1 : ['a', 'c'],  2: ['b']}

Fonctions connexes

La fonction MULTIMAP_FROM_ENTRIES fait partie des fonctions de type complexe. Pour plus d'informations sur les fonctions de traitement des données de types complexes (tels que ARRAY, MAP, STRUCT et JSON), consultez la page Complex type functions.