Categorias:

Funções de dados semiestruturados e estruturados (Conversão)

AS_ARRAY

Converte um valor de VARIANT em uma matriz.

Consulte também:

AS_<tipo_de_objeto> , AS_OBJECT

Sintaxe

AS_ARRAY( <variant_expr> )
Copy

Argumentos

variant_expr

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

Notas de uso

  • Se o variant_expr não contiver um valor do tipo ARRAY, então a função retornará NULL.

  • Esta função não oferece suporte a um tipo estruturado como argumento de entrada.

Exemplos

Isso mostra como usar a função:

Criar uma tabela e dados:

CREATE TABLE multiple_types (
    array1 VARIANT,
    array2 VARIANT,
    boolean1 VARIANT,
    char1 VARIANT,
    varchar1 VARIANT,
    decimal1 VARIANT,
    double1 VARIANT,
    integer1 VARIANT,
    object1 VARIANT
    );
INSERT INTO multiple_types 
     (array1, array2, boolean1, char1, varchar1, 
      decimal1, double1, integer1, object1)
   SELECT 
     TO_VARIANT(TO_ARRAY('Example')), 
     TO_VARIANT(ARRAY_CONSTRUCT('Array-like', 'example')), 
     TO_VARIANT(TRUE), 
     TO_VARIANT('X'), 
     TO_VARIANT('I am a real character'), 
     TO_VARIANT(1.23::DECIMAL(6, 3)),
     TO_VARIANT(3.21::DOUBLE),
     TO_VARIANT(15),
     TO_VARIANT(TO_OBJECT(PARSE_JSON('{"Tree": "Pine"}')))
     ;
Copy

Agora execute a consulta. As verdadeiras matrizes que foram armazenadas como valores VARIANT são convertidas de volta para valores ARRAY. Entretanto, o valor na coluna objeto1, que não era um ARRAY verdadeiro, será convertido em NULL.

SELECT 
       AS_ARRAY(array1) AS "ARRAY1",
       AS_ARRAY(array2) AS "ARRAY2",
       AS_OBJECT(object1) AS "OBJECT",
       AS_ARRAY(object1) AS "OBJECT AS ARRAY"
  FROM multiple_types;
+-------------+-----------------+------------------+-----------------+
| ARRAY1      | ARRAY2          | OBJECT           | OBJECT AS ARRAY |
|-------------+-----------------+------------------+-----------------|
| [           | [               | {                | NULL            |
|   "Example" |   "Array-like", |   "Tree": "Pine" |                 |
| ]           |   "example"     | }                |                 |
|             | ]               |                  |                 |
+-------------+-----------------+------------------+-----------------+
Copy