Di MariaDB, JSON_MERGE() adalah fungsi bawaan yang menggabungkan dua atau lebih dokumen JSON dan mengembalikan hasilnya.
JSON_MERGE() fungsi telah ditinggalkan, dan untuk menghindari masalah di masa mendatang, Anda harus menggunakan JSON_MERGE_PATCH() fungsi sebagai gantinya. JSON_MERGE_PATCH() function adalah pengganti yang sesuai dengan RFC 7396 untuk JSON_MERGE() .
Sintaks
Sintaksnya seperti ini:
JSON_MERGE(json_doc, json_doc[, json_doc] ...)
Dimana json_doc adalah dokumen JSON untuk digabungkan.
Contoh
Berikut ini contoh untuk didemonstrasikan.
SELECT JSON_MERGE('{"name":"Wag"}', '{"type":"Dog"}'); Hasil:
+------------------------------------------------+
| JSON_MERGE('{"name":"Wag"}', '{"type":"Dog"}') |
+------------------------------------------------+
| {"name": "Wag", "type": "Dog"} |
+------------------------------------------------+ Kita dapat melihat bahwa kedua dokumen tersebut telah digabungkan menjadi satu.
Berikut adalah contoh yang menggabungkan tiga dokumen:
SELECT JSON_MERGE(
'{ "name" : "Wag" }',
'{ "type" : "Dog" }',
'{ "score" : [ 9, 7, 8 ] }'
) AS Result; Hasil:
+----------------------------------------------------+
| Result |
+----------------------------------------------------+
| {"name": "Wag", "type": "Dog", "score": [9, 7, 8]} |
+----------------------------------------------------+ Array
Satu perbedaan antara JSON_MERGE() dan JSON_MERGE_PATCH() apakah itu JSON_MERGE() menggabungkan array (JSON_MERGE_PATCH() tidak):
SELECT JSON_MERGE(
'[1,2,3]',
'[4,5,6]'
) AS Result; Hasil:
+--------------------+ | Result | +--------------------+ | [1, 2, 3, 4, 5, 6] | +--------------------+
Mencoba ini dengan JSON_MERGE_PATCH() hanya menghasilkan larik kedua yang dikembalikan.
Argumen Null
Jika ada argumen NULL , hasilnya adalah NULL :
SELECT
JSON_MERGE('{"a":1}', null) AS a,
JSON_MERGE(null, '{"a":1}') AS b,
JSON_MERGE(null, null) AS c; Hasil:
+------+------+------+ | a | b | c | +------+------+------+ | NULL | NULL | NULL | +------+------+------+
Jumlah Parameter Salah
Memanggil fungsi tanpa argumen menghasilkan kesalahan:
SELECT JSON_MERGE(); Hasil:
ERROR 1582 (42000): Incorrect parameter count in the call to native function 'JSON_MERGE'
Sama halnya jika Anda hanya memberikan satu argumen:
SELECT JSON_MERGE('{"a":1}'); Hasil:
ERROR 1582 (42000): Incorrect parameter count in the call to native function 'JSON_MERGE'