Catégories :

Fonctions de données semi-structurées et structurées (conversion)

AS_ARRAY

Convertit une valeur VARIANT en valeur ARRAY.

Voir aussi :

AS_<type_objet> , AS_OBJECT

Syntaxe

AS_ARRAY( <variant_expr> ) 
Copy

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')); 
Copy

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; 
Copy
+-------------+-----------------+ | ARRAY1 | ARRAY2 | |-------------+-----------------| | [ | [ | | "Example" | "Array-like", | | ] | "example" | | | ] | +-------------+-----------------+