Catégories :

Fonctions de données semi-structurées et 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> )
Copy

Arguments

array

Le tableau source.

new_element

L’élément à ajouter. Le type de l’élément dépend du type du tableau :

  • Si array est un ARRAY semi-structuré, l’élément peut être 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.

  • Si array est un ARRAY structuré, le type du nouvel élément doit être coercible (pouvoir être contraint à se transformer) dans le type du ARRAY.

Renvoie

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

Notes sur l’utilisation

  • Lorsque vous transmettez un ARRAY structuré à la fonction, celle-ci renvoie un ARRAY structuré du même type.

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