Categorias:

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

ARRAY_APPEND

Retorna uma matriz contendo todos os elementos da matriz de origem, bem como o novo elemento. O novo elemento está localizado no fim da matriz.

Consulte também:

ARRAY_INSERT , ARRAY_PREPEND

Sintaxe

ARRAY_APPEND( <array> , <new_element> )
Copy

Argumentos

array

A matriz de origem.

new_element

O elemento a ser anexado. O tipo do elemento depende do tipo da matriz:

  • Se array for uma ARRAY semiestruturada, o elemento pode ser de quase todos os tipos de dados. O tipo de dados não precisa corresponder ao(s) tipo(s) de dados dos elementos existentes na matriz.

  • Se array for uma ARRAY estruturada, o tipo do novo elemento deverá ser coercível ao tipo de ARRAY.

Retornos

O tipo de dados do valor retornado é ARRAY.

Notas de uso

  • Quando você passa uma ARRAY estruturada para a função, a função retorna uma ARRAY estruturada do mesmo tipo.

Exemplos

Este é um exemplo simples de criação de uma matriz (com a função ARRAY_CONSTRUCT) e depois anexação a essa matriz. Observe que o elemento anexado não precisa ser do mesmo tipo de dados que os outros elementos da matriz.

Executar a consulta:

SELECT ARRAY_APPEND(ARRAY_CONSTRUCT(1, 2, 3), 'HELLO');
+-------------------------------------------------+
| ARRAY_APPEND(ARRAY_CONSTRUCT(1, 2, 3), 'HELLO') |
|-------------------------------------------------|
| [                                               |
|   1,                                            |
|   2,                                            |
|   3,                                            |
|   "HELLO"                                       |
| ]                                               |
+-------------------------------------------------+
Copy
Linguagem: Português