Tous les produits
Search
Centre de documentation

MaxCompute:MAP_FROM_ARRAYS

Dernière mise à jour :Aug 10, 2026

La fonction MAP_FROM_ARRAYS combine les tableaux ARRAY a et b en un objet MAP.

Syntaxe

MAP<K, V> MAP_FROM_ARRAYS([STRING <mapDupKeyPolicy>,] ARRAY<K> <a>, ARRAY<V> <b>)

Paramètres

  • mapDupKeyPolicy : facultatif. Type STRING. Spécifie la méthode de gestion des clés dupliquées. Les valeurs possibles sont les suivantes :

    • exception : renvoie une erreur si des clés dupliquées sont détectées.

    • last_win : en cas de clé dupliquée, la dernière valeur écrase les précédentes.

    Vous pouvez également définissez ce paramètre au niveau de la session à l'aide du paramètre odps.sql.map.key.dedup.policy, par exemple set odps.sql.map.key.dedup.policy=exception;. La valeur par défaut est last_win si le paramètre n'est pas configuré.

    Remarque

    Le comportement de MaxCompute privilégie la valeur de mapDupKeyPolicy spécifiée dans la fonction. Si mapDupKeyPolicy n'est pas configuré dans la fonction, la valeur du paramètre odps.sql.map.key.dedup.policy s'applique.

  • a : obligatoire. Tableau ARRAY. Correspond aux clés du MAP généré. Dans array<K>, K représente le type de données des éléments du tableau ARRAY ; les éléments peuvent être de n'importe quel type.

  • b : obligatoire. Tableau ARRAY. Correspond aux valeurs du MAP généré. Dans array<V>, V représente le type de données des éléments du tableau ARRAY ; les éléments peuvent être de n'importe quel type.

Valeur de retour

Renvoie un type MAP. Les règles de retour sont les suivantes :

  • Si a ou b est NULL, le résultat renvoyé est NULL.

  • Une erreur est renvoyée si les éléments de a contiennent des valeurs NULL ou si les longueurs des deux tableaux diffèrent.

Exemples

--返回{"1.0": "2", "3.0": "4"}。
SELECT MAP_FROM_ARRAYS(ARRAY(1.0, 3.0), ARRAY('2', '4'));

--返回{"1.0": "2", "3.0": "6"}。
SELECT MAP_FROM_ARRAYS('last_win', ARRAY(1.0, 3.0, 3), ARRAY('2', '4', '6'));

Fonctions associées

La fonction MAP_FROM_ARRAYS appartient aux fonctions de types complexes. Pour plus d'informations sur les fonctions de traitement des données de types complexes (telles que ARRAY, MAP, STRUCT et JSON), consultez Complex type functions.