Catégories :

Fonctions de données semi-structurées (tableau/objet)

ARRAY_APPEND

Renvoie un tableau contenant tous les éléments du tableau source ainsi que le nouvel élément. Le nouvel élément est situé à la fin du tableau.

Voir aussi :

ARRAY_INSERT , ARRAY_PREPEND

Syntaxe

ARRAY_APPEND( <array> , <new_element> )

Arguments

tableau

Le tableau source.

nouvel_élément

L’élément à ajouter. L’élément peut être de presque n’importe quel type de données. Le type de données n’a pas besoin de correspondre au(x) type(s) de données des éléments existants dans le tableau.

Renvoie

Le type de données de la valeur renvoyée est ARRAY.

Exemples

Ceci est un exemple simple de construction d’un tableau (avec la fonction ARRAY_CONSTRUCT), puis d’ajout à ce tableau. Notez que l’élément ajouté n’a pas besoin d’être du même type de données que les autres éléments du tableau.

Exécutez la requête :

SELECT ARRAY_APPEND(ARRAY_CONSTRUCT(1, 2, 3), 'HELLO');
+-------------------------------------------------+
| ARRAY_APPEND(ARRAY_CONSTRUCT(1, 2, 3), 'HELLO') |
|-------------------------------------------------|
| [                                               |
|   1,                                            |
|   2,                                            |
|   3,                                            |
|   "HELLO"                                       |
| ]                                               |
+-------------------------------------------------+