Categorias:

Funções de dados semiestruturados e estruturados (Matriz/objeto)

ARRAY_CONSTRUCT

Retorna uma matriz construída a partir de zero, uma ou mais entradas.

Consulte também:

ARRAY_CONSTRUCT_COMPACT

Sintaxe

ARRAY_CONSTRUCT( [ <expr1> ] [ , <expr2> [ , ... ] ] )
Copy

Argumentos

Os argumentos são valores (ou expressões avaliadas como valores). Os argumentos não precisam ser todos do mesmo tipo de dados.

Retornos

O tipo de dados do valor retornado é ARRAY.

Notas de uso

  • Os tipos de dados das entradas podem variar.

  • Se a função for chamada com N argumentos, o tamanho da matriz resultante será N.

  • Em muitos contextos, você pode usar uma constante de ARRAY (também chamada de literal de ARRAY) em vez da função ARRAY_CONSTRUCT.

Exemplos

Construir uma matriz básica que consiste em tipos de dados numéricos:

SELECT ARRAY_CONSTRUCT(10, 20, 30);
+-----------------------------+
| ARRAY_CONSTRUCT(10, 20, 30) |
|-----------------------------|
| [                           |
|   10,                       |
|   20,                       |
|   30                        |
| ]                           |
+-----------------------------+
Copy

Construir uma matriz básica que consiste de diferentes tipos de dados:

SELECT ARRAY_CONSTRUCT(null, 'hello', 3::double, 4, 5);
+-------------------------------------------------+
| ARRAY_CONSTRUCT(NULL, 'HELLO', 3::DOUBLE, 4, 5) |
|-------------------------------------------------|
| [                                               |
|   undefined,                                    |
|   "hello",                                      |
|   3.000000000000000e+00,                        |
|   4,                                            |
|   5                                             |
| ]                                               |
+-------------------------------------------------+
Copy

Construir uma matriz vazia:

SELECT ARRAY_CONSTRUCT();
+-------------------+
| ARRAY_CONSTRUCT() |
|-------------------|
| []                |
+-------------------+
Copy