- Kategorien:
Semistrukturierte Datenfunktionen (Array/Objekt)
OBJECT_INSERT¶
Gibt ein Objekt zurück, das aus dem Eingabeobjekt mit einem neu eingefügten Schlüssel-Wert-Paar besteht (oder einem bestehenden Schlüssel, der mit einem neuen Wert aktualisiert wurde).
Syntax¶
OBJECT_INSERT( <object> , <key> , <value> [ , <updateFlag> ] )
Argumente¶
Benötigt:
object
Das Quellobjekt, in das das neue Schlüssel-Wert-Paar eingefügt wird.
key
Der neue Schlüssel, der in das Objekt eingefügt werden soll. Muss sich von allen im Objekt vorhandenen Schlüsseln unterscheiden, es sei denn,
updateFlag
ist auf TRUE gesetzt.value
Der dem Schlüssel zugeordnete Wert.
Optional:
updateFlag
Boolesches Flag, das bei der Einstellung TRUE angibt, dass der Eingabewert zum Aktualisieren/Überschreiben eines vorhandenen Schlüssels im Objekt verwendet werden soll, anstatt ein neues Schlüssel-Wert-Paar einzufügen.
Der Standardwert ist FALSE.
Nutzungshinweise¶
Die Funktion unterstützt JSON NULL-Werte, aber keine SQL NULL-Werte oder -Schlüssel:
Wenn der Schlüssel
key
eine beliebige andere Zeichenfolge als NULL ist und der Wertvalue
ein JSON-NULL-Wert ist (z. B.PARSE_JSON('NULL')
), wird das Schlüssel-Wert-Paar in das zurückgegebene Objekt eingefügt.Wenn entweder
key
odervalue
ein SQL-NULL-Wert ist, wird das Schlüssel-Wert-Paar aus dem zurückgegebenen Objekt weggelassen.
Wenn das optionale
updateFlag
-Argument auf TRUE gesetzt ist, wird der vorhandene Eingabeschlüsselkey
auf den Eingabewertvalue
aktualisiert. WennupdateFlag
weggelassen oder auf FALSE gesetzt wird, führt das Aufrufen dieser Funktion mit einem Eingabeschlüssel, der bereits im Objekt vorhanden ist, zu einem Fehler.Wenn das Aktualisierungsflag auf „TRUE“ gesetzt ist, aber der entsprechende Schlüssel noch nicht im Objekt vorhanden ist, wird das Schlüssel/Wert-Paar hinzugefügt.
Beispiele¶
Einfügen eines dritten Schlüssel-Wert-Paars in ein Objekt, das zwei Schlüssel-Wert-Paare enthält:
SELECT OBJECT_INSERT(OBJECT_CONSTRUCT('a',1,'b',2),'c',3); ----------------------------------------------------+ OBJECT_INSERT(OBJECT_CONSTRUCT('A',1,'B',2),'C',3) | ----------------------------------------------------+ { | "a": 1, | "b": 2, | "c": 3 | } | ----------------------------------------------------+
Einfügen von zwei neuen Schlüssel-Wert-Paaren in ein leeres Objekt, wobei ein Schlüssel-Wert-Paar weglassen wird:
Key_One
besteht aus einem JSON NULL-Wert.
Key_Two
besteht aus einem SQL NULL-Wert und wird daher weggelassen.
Key_Three
besteht aus einer Zeichenfolge, die „null“ enthält.SELECT OBJECT_INSERT(OBJECT_INSERT(OBJECT_INSERT(OBJECT_CONSTRUCT(), 'Key_One', PARSE_JSON('NULL')), 'Key_Two', NULL), 'Key_Three', 'null') AS obj; -----------------------+ OBJ | -----------------------+ { | "Key_One": null, | "Key_Three": "null" | } | -----------------------+
Aktualisieren eines vorhandenen Schlüssel-Wert-Paares ("k1": 100
) mit einem neuen Wert ("string-value"
):
SELECT OBJECT_INSERT(OBJECT_INSERT(OBJECT_CONSTRUCT(),'k1', 100),'k1','string-value', TRUE) AS obj; ------------------------+ OBJ | ------------------------+ { | "k1": "string-value" | } | ------------------------+