AS_ARRAY¶

Sintaxe¶

AS_ARRAY( <variant_expr> )

Argumentos¶

variant_expr

Uma expressão que avalia como um valor do tipo VARIANT.

Retornos¶

A função retorna um valor do tipo ARRAY ou NULL:

• Se o tipo do valor no argumento variant_expr for ARRAY, a função retornará um valor do tipo ARRAY.

• Se o tipo do valor no argumento variant_expr não corresponder ao tipo do valor de saída, a função retornará NULL.

• Se o argumento variant_expr for NULL, a função retornará NULL.

Notas de uso¶

• Essa função não é compatível com um tipo estruturado como argumento de entrada.

Exemplos¶

Criar uma tabela e carregar dados nela:

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

Use a função AS_ARRAY em uma consulta para converter um valor VARIANT em valores ARRAY:

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

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