Catégories :

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

TO_ARRAY

Convertit l’expression d’entrée en ARRAY :

  • Si l’entrée est un ARRAY ou VARIANT contenant une valeur de tableau, le résultat est inchangé.

  • Pour NULL ou une entrée JSON null, renvoie NULL.

  • Pour toute autre valeur, le résultat est un tableau à un seul élément contenant cette valeur.

Syntaxe

TO_ARRAY( <expr> )
Copy

Arguments

expr

Une expression de tout type de données.

Notes sur l’utilisation

  • Pour créer un tableau contenant plusieurs valeurs, vous pouvez utiliser ARRAY_CONSTRUCT.

Exemples

Cet exemple montre comment utiliser TO_ARRAY() :

Créez une table simple et insérez des données en appelant la fonction TO_ARRAY :

CREATE TABLE array_demo_2 (ID INTEGER, array1 ARRAY, array2 ARRAY);
Copy
INSERT INTO array_demo_2 (ID, array1, array2) 
    SELECT 1, TO_ARRAY(1), TO_ARRAY(3);
Copy

Exécutez une requête affichant les tableaux à élément unique créés lors de l’insertion, ainsi que le résultat de l’appel de ARRAY_CAT pour concaténer les deux tableaux :

SELECT array1, array2, ARRAY_CAT(array1, array2) FROM array_demo_2;
+--------+--------+---------------------------+
| ARRAY1 | ARRAY2 | ARRAY_CAT(ARRAY1, ARRAY2) |
|--------+--------+---------------------------|
| [      | [      | [                         |
|   1    |   3    |   1,                      |
| ]      | ]      |   3                       |
|        |        | ]                         |
+--------+--------+---------------------------+
Copy