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

ARRAY_CAT¶

Retorna uma concatenação de duas matrizes.

Sintaxe¶

ARRAY_CAT( <array1> , <array2> )

Copy

Argumentos¶

array1: A matriz de origem.
array2: A matriz a ser anexada ao array1.

Retornos¶

Uma ARRAY contendo os elementos de array2 anexados após os elementos de array1.

Notas de uso¶

Ambos os argumentos devem ser ARRAYs estruturadas ou ARRAYs semiestruturadas.

Se você estiver passando ARRAYs semiestruturadas, ambos os argumentos devem ser do tipo de ARRAY ou VARIANT contendo uma matriz.
Se você estiver passando ARRAYs estruturadas, a função retornará uma ARRAY de um tipo que pode acomodar ambos os tipos de entrada.
Se qualquer dos argumentos for NULL, a função retorna NULL sem relatar qualquer erro.

Exemplos¶

Este exemplo mostra como usar ARRAY_CAT():

Criar uma tabela e dados simples:

CREATE TABLE array_demo (ID INTEGER, array1 ARRAY, array2 ARRAY);

Copy

INSERT INTO array_demo (ID, array1, array2) 
    SELECT 1, ARRAY_CONSTRUCT(1, 2), ARRAY_CONSTRUCT(3, 4);

Copy

Executar a consulta:

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

Copy