Catégories :: Fonctions de données semi-structurées et structurées (Carte)

MAP_CAT¶

Renvoie la concaténation de deux MAPs.

Syntaxe¶

MAP_CAT( <map1> , <map2> )

Copy

Arguments¶

map1: La MAP source.
map2: La MAP à ajouter à map1.

Renvoie¶

Le type de retour de cette fonction est le type de map1. map2 est contraint de se transformer en type map1 conformément aux règles de conversion contrainte. Pour des informations sur les règles de conversion contrainte, voir Casting (Conversion) implicite d’une valeur (coercition ou conversion contrainte).

Notes sur l’utilisation¶

Si map1 et map2 ont toutes les deux une valeur avec la même clé, la carte de sortie contient la valeur de map2.
Si l’un des deux arguments est NULL, la fonction renvoie NULL sans signaler d’erreur.

Exemples¶

Créer deux MAPs et les concaténer :

SELECT MAP_CAT(
  {'map1key1':'map1value1','map1key2':'map1value2'}::MAP(VARCHAR,VARCHAR),
  {'map2key1':'map2value1','map2key2':'map2value2'}::MAP(VARCHAR,VARCHAR))
  AS concatenated_maps;

Copy

+-----------------------------+
| CONCATENATED_MAPS           |
|-----------------------------|
| {                           |
|   "map1key1": "map1value1", |
|   "map1key2": "map1value2", |
|   "map2key1": "map2value1", |
|   "map2key2": "map2value2"  |
| }                           |
+-----------------------------+