JSON

JSON_ARRAY_APPEND

MySQLMySQL

Menambahkan nilai ke akhir array di JSON document. Path harus menunjuk ke array yang ada.

Tipe hasil: JSONDiperbarui: 16 Mei 2026

Syntax

SQL
JSON_ARRAY_APPEND(json_doc, path, val[, path, val] ...)

Parameter

json_docJSONwajib

JSON document sumber

pathVARCHARwajib

Path ke array yang akan ditambahkan

valanywajib

Nilai yang akan ditambahkan ke array

Contoh Penggunaan

Append to Array

SQL
1SELECT JSON_ARRAY_APPEND('{"tags": ["a", "b"]}', '$.tags', 'c') AS result;

Menambahkan 'c' ke akhir array tags.

Hasil
{"tags": ["a", "b", "c"]}

Append Multiple Values

SQL
1SELECT JSON_ARRAY_APPEND('{"items": [1]}', '$.items', 2, '$.items', 3) AS result;

Menambahkan 2 dan 3 berurutan.

Hasil
{"items": [1, 2, 3]}

Add Tag to Product

SQL
1UPDATE products
2SET tags = JSON_ARRAY_APPEND(tags, '$', 'new-tag')
3WHERE id = 1;

Menambahkan tag baru ke produk.

Hasil
(tag appended)

Pertanyaan Umum tentang JSON_ARRAY_APPEND

Apa itu fungsi JSON_ARRAY_APPEND di MySQL?
Menambahkan nilai ke akhir array di JSON document. Path harus menunjuk ke array yang ada. Di MySQL, fungsi JSON_ARRAY_APPEND termasuk dalam kelompok fungsi yang sering digunakan untuk mengolah dan menganalisis data secara efisien.
Bagaimana cara menggunakan JSON_ARRAY_APPEND di MySQL?
Gunakan sintaks berikut: JSON_ARRAY_APPEND(json_doc, path, val[, path, val] ...). Pastikan argumen yang dimasukkan sudah sesuai dengan tipe data yang diharapkan.
Apa nilai yang dikembalikan oleh fungsi JSON_ARRAY_APPEND?
Fungsi JSON_ARRAY_APPEND mengembalikan nilai bertipe JSON. Pastikan tipe data hasil sudah sesuai dengan kebutuhan query atau formula kamu. Jika input mengandung nilai NULL, perilaku fungsi dapat berbeda — selalu periksa dokumentasi untuk memastikan hasilnya sesuai ekspektasi.
Apa saja parameter fungsi JSON_ARRAY_APPEND?
Fungsi ini memiliki 3 parameter wajib. Parameter yang digunakan: json_doc (JSON, wajib): JSON document sumber; path (VARCHAR, wajib): Path ke array yang akan ditambahkan; val (any, wajib): Nilai yang akan ditambahkan ke array.