Halaman ini diterjemahkan dari bahasa Inggris dengan bantuan AI. Jika keduanya berbeda, versi bahasa Inggris menjadi acuannya.
JSON_INSERT
Menyisipkan nilai baru ke dalam dokumen JSON pada jalur yang ditentukan tanpa menimpa nilai yang sudah ada.
Lihat juga:
[SELECT] [JSON_EXTRACT] [JSON_SET] [JSON_REPLACE]
Sintaksis
SELECT JSON_INSERT(json_column, path, new_value) FROM <multipartIdentifier>;
Argumen
json_column
Kolom atau ekspresi JSON yang akan diubah.
path
Ekspresi jalur JSON tempat nilai baru akan disisipkan. Jika jalur tersebut sudah ada, nilai asli pada jalur itu tidak diganti.
new_value
Nilai yang akan disisipkan pada jalur yang ditentukan di dalam dokumen JSON.
Nilai yang dikembalikan
Mengembalikan dokumen JSON dengan nilai baru yang telah disisipkan jika jalur yang ditentukan belum ada; jika sudah ada, dokumen JSON dikembalikan tanpa perubahan.
| Fungsi | Timpa jika sudah ada? | Buat jika belum ada? |
|---|---|---|
json_insert() | Tidak | Ya |
json_replace() | Ya | Tidak |
json_set() | Ya | Ya |
Contoh
Menyisipkan pasangan kunci-nilai baru ke dalam objek JSON
-- Example: Insert a new 'region' key with the value 'Europe' into a JSON object
SELECT JSON_INSERT(json_data, '$.region', 'Europe') as updated_object;
/* expected output...
|-----------------------------------------------------------|
| updated_object |
|-----------------------------------------------------------|
| {"name":"ResourceOne","type":"Storage","region":"Europe"} |
|-----------------------------------------------------------|
*/
Kueri ini menyisipkan kunci baru bernama 'region' dengan nilai 'Europe' ke dalam dokumen JSON jika kunci 'region' belum ada. Jika 'region' sudah menjadi kunci di dalam dokumen, dokumen asli dikembalikan tanpa perubahan.