In MariaDB, JSON_MERGE_PATCH()
è una funzione incorporata che unisce due o più documenti JSON e restituisce il risultato.
Il JSON_MERGE_PATCH()
funzione è un sostituto conforme a RFC 7396 per JSON_MERGE()
funzione, che è stata deprecata.
Sintassi
La sintassi è questa:
JSON_MERGE_PATCH(json_doc, json_doc[, json_doc] ...)
Dove json_doc
sono i documenti JSON da unire.
Esempio
Ecco un esempio da dimostrare.
SELECT JSON_MERGE_PATCH('{"name":"Wag"}', '{"type":"Dog"}');
Risultato:
+------------------------------------------------------+ | JSON_MERGE_PATCH('{"name":"Wag"}', '{"type":"Dog"}') | +------------------------------------------------------+ | {"name": "Wag", "type": "Dog"} | +------------------------------------------------------+
Possiamo vedere che i due documenti sono stati uniti in uno.
Ecco un esempio che unisce tre documenti:
SELECT JSON_MERGE_PATCH(
'{ "name" : "Wag" }',
'{ "type" : "Dog" }',
'{ "score" : [ 9, 7, 8 ] }'
) AS Result;
Risultato:
+----------------------------------------------------+ | Result | +----------------------------------------------------+ | {"name": "Wag", "type": "Dog", "score": [9, 7, 8]} | +----------------------------------------------------+
Array
Il JSON_MERGE_PATCH()
la funzione non unisce gli array:
SELECT JSON_MERGE_PATCH(
'[1,2,3]',
'[4,5,6]'
) AS Result;
Risultato:
+-----------+ | Result | +-----------+ | [4, 5, 6] | +-----------+
Questo è in contrasto con il (obsoleto) JSON_MERGE()
funzione e il suo sinonimo JSON_MERGE_PRESERVE()
, entrambi uniscono gli array.
Formato del risultato
Potresti aver notato che JSON_MERGE_PATCH()
aggiunge spazi al documento risultante. Se questo è un problema, puoi usare JSON_COMPACT()
per rimuovere lo spazio.
Esempio:
SELECT
JSON_COMPACT(
JSON_MERGE_PATCH(
'{"name":"Wag"}',
'{"type":"Dog"}',
'{"score":[9,7,8]}'
)
) AS Result;
Risultato:
+---------------------------------------------+ | Result | +---------------------------------------------+ | {"name":"Wag","type":"Dog","score":[9,7,8]} | +---------------------------------------------+
Ma se devi andare dall'altra parte e ottenere una formattazione aggiuntiva, come strutture rientrate, prova JSON_DETAILED()
funzione.
SELECT
JSON_DETAILED(
JSON_MERGE_PATCH(
'{ "name" : "Wag" }',
'{ "type" : "Dog" }',
'{ "score" : [ 9, 7, 8 ] }'
)
) AS Result;
Risultato:
+---------------------------------------+ | Result | +---------------------------------------+ | { "name": "Wag", "type": "Dog", "score": [ 9, 7, 8 ] } | +---------------------------------------+
Argomento nullo
Se un argomento è NULL
, il risultato è NULL
:
SELECT
JSON_MERGE_PATCH('{"a":1}', null) AS a,
JSON_MERGE_PATCH(null, '{"a":1}') AS b,
JSON_MERGE_PATCH(null, null) AS c;
Risultato:
+------+------+------+ | a | b | c | +------+------+------+ | NULL | NULL | NULL | +------+------+------+
Conteggio parametri errato
La chiamata della funzione senza argomenti genera un errore:
SELECT JSON_MERGE_PATCH();
Risultato:
ERROR 1582 (42000): Incorrect parameter count in the call to native function 'JSON_MERGE_PATCH'
È lo stesso quando fornisci un solo argomento:
SELECT JSON_MERGE_PATCH('{"a":1}');
Risultato:
ERROR 1582 (42000): Incorrect parameter count in the call to native function 'JSON_MERGE_PATCH'