Lewati ke konten utama
Halaman terjemahan

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

JSON_SET

Memperbarui nilai yang sudah ada atau menyisipkan nilai baru dalam dokumen JSON pada jalur yang ditentukan.

Lihat juga:
[SELECT] [JSON_EXTRACT] [JSON_SET] [JSON_REPLACE]


Sintaksis​

SELECT JSON_SET(json_column, path, value_to_set) FROM <multipartIdentifier>;

Argumen​

json_column
Kolom atau ekspresi JSON yang akan dimodifikasi.

path
Ekspresi jalur JSON yang menunjukkan tempat nilai akan ditetapkan. Jika jalur sudah ada, nilainya diperbarui; jika jalur belum ada, pasangan kunci-nilai baru ditambahkan.

value_to_set
Nilai yang akan ditetapkan pada jalur yang ditentukan dalam dokumen JSON.

Nilai yang dikembalikan​

Mengembalikan dokumen JSON dengan nilai yang ditetapkan pada jalur yang ditentukan. Jika jalur sudah ada, nilai yang ada diperbarui; jika tidak, pasangan kunci-nilai baru ditambahkan.

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

Contoh​

Memperbarui nilai yang sudah ada dalam objek JSON​

-- Example: Update the 'status' key's value to 'active' in a JSON object
SELECT JSON_SET(json_data, '$.status', 'active') as updated_json
FROM cloud_services
WHERE service_id = 'service123';

-- Expected output:
-- |---------------------------------------------------------|
-- | updated_json |
-- |---------------------------------------------------------|
-- | {"name":"ServiceOne", "status":"active", "region":"US"} |
-- |---------------------------------------------------------|

Kueri ini memperbarui kunci 'status' menjadi 'active' dalam dokumen JSON jika kunci 'status' sudah ada. Jika 'status' tidak ada dalam dokumen, kunci tersebut ditambahkan dengan nilai 'active'.

Menambahkan pasangan kunci-nilai baru ke objek JSON​

-- Example: Add a new key 'lastChecked' with the current date to a JSON object
SELECT JSON_SET(json_data, '$.lastChecked', '2024-04-29') as updated_json
FROM cloud_services
WHERE service_id = 'service123';

/* expected output...
|-----------------------------------------------------------------------|
| updated_json |
|-----------------------------------------------------------------------|
| {"name":"ServiceOne", "status":"pending", "lastChecked":"2024-04-29"} |
|-----------------------------------------------------------------------|
*/

Kueri ini menambahkan kunci baru 'lastChecked' dengan nilai '2024-04-29' ke dokumen JSON jika 'lastChecked' belum ada. Jika sudah ada, nilai yang ada diperbarui menjadi '2024-04-29'.