JSON

JSON_SEARCH

MySQLMySQL

Mencari string value di JSON document dan mengembalikan path ke value tersebut.

Tipe hasil: JSON (path or array of paths)Diperbarui: 16 Mei 2026

Syntax

SQL
JSON_SEARCH(json_doc, one_or_all, search_str[, escape_char[, path] ...])

Parameter

json_docJSONwajib

JSON document untuk pencarian

one_or_allVARCHARwajib

'one' = return path pertama, 'all' = return semua path

search_strVARCHARwajib

String yang dicari (support wildcard % dan _)

escape_charCHARopsional

Karakter escape (default NULL)

pathVARCHARopsional

Path scope untuk pencarian

Contoh Penggunaan

Find String Value

SQL
1SELECT JSON_SEARCH('{"name": "John", "city": "New York"}', 'one', 'John') AS path;

Mencari 'John' dan mendapatkan path-nya.

Hasil
path: "$.name"

Search with Wildcard

SQL
1SELECT JSON_SEARCH('{"items": ["apple", "apricot", "banana"]}', 'all', 'ap%') AS paths;

Mencari semua value yang dimulai dengan 'ap'.

Hasil
paths: ["$.items[0]", "$.items[1]"]

Find User by Email

SQL
1SELECT id, JSON_SEARCH(data, 'one', '%@gmail.com') AS gmail_path
2FROM users
3WHERE JSON_SEARCH(data, 'one', '%@gmail.com') IS NOT NULL;

Mencari user dengan email Gmail.

Hasil
(users with Gmail)

Pertanyaan Umum tentang JSON_SEARCH

Apa itu fungsi JSON_SEARCH di MySQL?
Mencari string value di JSON document dan mengembalikan path ke value tersebut. Di MySQL, fungsi JSON_SEARCH termasuk dalam kelompok fungsi yang sering digunakan untuk mengolah dan menganalisis data secara efisien.
Bagaimana cara menggunakan JSON_SEARCH di MySQL?
Gunakan sintaks berikut: JSON_SEARCH(json_doc, one_or_all, search_str[, escape_char[, path] ...]). Pastikan argumen yang dimasukkan sudah sesuai dengan tipe data yang diharapkan.
Apa nilai yang dikembalikan oleh fungsi JSON_SEARCH?
Fungsi JSON_SEARCH mengembalikan nilai bertipe JSON (path or array of paths). 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_SEARCH?
Fungsi ini memiliki 3 parameter wajib dan 2 parameter opsional. Parameter yang digunakan: json_doc (JSON, wajib): JSON document untuk pencarian; one_or_all (VARCHAR, wajib): 'one' = return path pertama, 'all' = return semua path; search_str (VARCHAR, wajib): String yang dicari (support wildcard % dan _); escape_char (CHAR, opsional): Karakter escape (default NULL); path (VARCHAR, opsional): Path scope untuk pencarian.