Lewati ke konten utama
Halaman terjemahan

Halaman ini diterjemahkan dari bahasa Inggris dengan bantuan AI. Jika keduanya berbeda, versi bahasa Inggris menjadi acuannya.

JSON_PATCH

Menerapkan JSON MergePatch (RFC-7396) ke dokumen JSON dan mengubahnya sesuai operasi yang ditentukan. Fungsi ini digunakan untuk menambahkan, mengubah, atau menghapus elemen di dalam objek JSON, tetapi memperlakukan array JSON sebagai unit atomik.

Lihat juga:
[SELECT] [JSON_EXTRACT]


Sintaksis​

SELECT JSON_PATCH(target_json, patch_json) FROM <multipartIdentifier>;

Argumen​

target_json
Dokumen JSON yang akan di-patch.

patch_json
Dokumen JSON yang menjelaskan perubahan yang akan diterapkan menurut algoritma MergePatch.

Nilai yang dikembalikan​

Mengembalikan dokumen JSON yang telah diubah setelah patch diterapkan.


Contoh​

MergePatch sederhana​

-- Example: Simple merge of new elements into the target JSON object
SELECT JSON_PATCH('{"a":1,"b":2}', '{"c":3,"d":4}') AS patched_json;

Output: {"a":1,"b":2,"c":3,"d":4}

Mengganti elemen dalam array​

-- Example: Replacing an array with a single value in the JSON object
SELECT JSON_PATCH('{"a":[1,2],"b":2}', '{"a":9}') AS patched_json;

Output: {"a":9,"b":2}

Menghapus elemen menggunakan null​

-- Example: Removing an element by setting it to null
SELECT JSON_PATCH('{"a":1,"b":2}', '{"a":9,"b":null,"c":8}') AS patched_json;

Output: {"a":9,"c":8}

MergePatch bersarang​

-- Example: Nested merge patch updating sub-keys within a nested JSON object
SELECT JSON_PATCH('{"a":{"x":1,"y":2},"b":3}', '{"a":{"y":9},"c":8}') AS patched_json;

Output: {"a":{"x":1,"y":9},"b":3,"c":8}

Fungsionalitas ini memungkinkan pembaruan yang fleksibel dan dinamis terhadap JSON yang disimpan di database, dan sangat berguna bagi aplikasi yang memerlukan modifikasi struktur data secara kondisional.