Kategorien:: Funktionen für semistrukturierte und strukturierte Daten (Array/Objekt)

ARRAY_APPEND¶

Gibt ein Array zurück, das alle Elemente aus dem Quellarray sowie das neue Element enthält. Das neue Element befindet sich am Ende des Arrays.

Siehe auch:: ARRAY_INSERT, ARRAY_PREPEND

Syntax¶

ARRAY_APPEND( <array> , <new_element> )

Copy

Argumente¶

array

Das Quellarray.

new_element

Das Element, das angehängt werden soll. Der Typ des Elements hängt vom Typ des Arrays ab:

Wenn array ein semistrukturierter ARRAY-Typ ist, kann das Element fast jeden Datentyp haben. Der Datentyp muss nicht mit den Datentypen der vorhandenen Elemente im Array übereinstimmen.
Wenn array ein strukturierter ARRAY-Typ ist, muss der Typ des neuen Elements implizit umwandelbar (Koersion) in den ARRAY-Typ sein.

Rückgabewerte¶

Der Datentyp des zurückgegebenen Werts ist ARRAY.

Nutzungshinweise¶

Wenn Sie der Funktion ein strukturiertes ARRAY übergeben, gibt die Funktion ein strukturiertes ARRAY desselben Typs zurück.

Beispiele¶

Dies ist ein einfaches Beispiel für das Erstellen eines Arrays (mit der Funktion ARRAY_CONSTRUCT) und das anschließende Anhängen an dieses Array. Beachten Sie, dass das angehängte Element nicht den gleichen Datentyp wie die anderen Elemente im Array aufweisen muss.

Führen Sie die Abfrage aus:

SELECT ARRAY_APPEND(ARRAY_CONSTRUCT(1, 2, 3), 'HELLO');
+-------------------------------------------------+
| ARRAY_APPEND(ARRAY_CONSTRUCT(1, 2, 3), 'HELLO') |
|-------------------------------------------------|
| [                                               |
|   1,                                            |
|   2,                                            |
|   3,                                            |
|   "HELLO"                                       |
| ]                                               |
+-------------------------------------------------+

Copy