Lewati ke konten utama
Halaman terjemahan

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.

Perilaku jika kunci sudah ada
FungsiTimpa jika sudah ada?Buat jika belum ada?
json_insert()TidakYa
json_replace()YaTidak
json_set()YaYa

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.