Categorias:: Funções de conversão , Funções de dados semiestruturados e estruturados (Matriz/objeto)

TO_ARRAY¶

Converte a expressão de entrada em um ARRAY:

Se a entrada for um ARRAY, ou VARIANT contendo um valor de matriz, o resultado é inalterado.
Para NULL ou uma entrada JSON nula, retorna NULL.
Para qualquer outro valor, o resultado é uma matriz de um único elemento contendo este valor.

Sintaxe¶

TO_ARRAY( <expr> )

Copy

Argumentos¶

expr: Uma expressão de qualquer tipo de dados.

Notas de uso¶

Para criar uma matriz contendo mais de um valor, você pode usar ARRAY_CONSTRUCT.

Exemplos¶

Este exemplo mostra como usar TO_ARRAY():

Criar uma tabela simples e inserir dados chamando a função 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

Executar uma consulta mostrando as matrizes de um item criadas durante a inserção, e também mostrando o resultado da chamada ARRAY_CAT para concatenar as duas matrizes:

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

Copy