AS_ARRAY¶

Syntaxe¶

AS_ARRAY( <variant_expr> )

Arguments¶

variant_expr

Une expression qui correspond à une valeur de type VARIANT.

Renvoie¶

La fonction renvoie une valeur de type ARRAY ou NULL :

• Si le type de la valeur de l’argument variant_expr est ARRAY, la fonction renvoie une valeur de type ARRAY.

• Si le type de la valeur de l’argument variant_expr ne correspond pas au type de la valeur de sortie, la fonction renvoie NULL.

• Si l’argument variant_expr est NULL, la fonction renvoie NULL.

Notes sur l’utilisation¶

• Cette fonction ne prend pas en charge un type structuré comme argument d’entrée.

Exemples¶

Créer une table et y charger des données :

CREATE OR REPLACE TABLE as_array_example (
  array1 VARIANT,
  array2 VARIANT);

INSERT INTO as_array_example (array1, array2)
  SELECT
    TO_VARIANT(TO_ARRAY('Example')),
    TO_VARIANT(ARRAY_CONSTRUCT('Array-like', 'example'));

Utilisez la fonction AS_ARRAY dans une requête pour convertir une valeur VARIANT en valeurs ARRAY :

SELECT AS_ARRAY(array1) AS array1,
       AS_ARRAY(array2) AS array2
  FROM as_array_example;

+-------------+-----------------+
| ARRAY1      | ARRAY2          |
|-------------+-----------------|
| [           | [               |
|   "Example" |   "Array-like", |
| ]           |   "example"     |
|             | ]               |
+-------------+-----------------+