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