All Products
Search
Document Center

MaxCompute:JSON_CONTAINS

Last Updated:Dec 26, 2025

Fungsi `JSON_CONTAINS` memeriksa apakah objek JSON berisi elemen JSON tertentu.

Sintaksis

BOOLEAN JSON_CONTAINS(JSON <json>, JSON <candidate> [, STRING <json_path>])

-- Contoh standar.
-- Mengembalikan true.
SELECT JSON_CONTAINS(JSON '[1,2,3,4,5,6,7,8]', JSON '4');

Parameter

  • json: Wajib. Data JSON yang akan diperiksa. Tipe datanya adalah JSON.

  • candidate: Wajib. Elemen JSON yang dicari. Tipe datanya adalah JSON.

  • json_path: Opsional. Path JSON yang akan diperiksa. Tipe datanya adalah STRING. Jika parameter ini tidak ditentukan, fungsi akan memeriksa seluruh objek JSON secara default.

Nilai kembalian

Fungsi ini mengembalikan nilai BOOLEAN berdasarkan aturan berikut:

  • Jika elemen yang ditentukan terdapat dalam data json, fungsi mengembalikan true; jika tidak, mengembalikan false.

  • Jika json_path tidak ada atau tidak valid, fungsi mengembalikan false.

  • Jika json atau candidate bernilai NULL, fungsi mengembalikan NULL.

Contoh

-- Mengembalikan true.
SELECT JSON_CONTAINS(JSON '[1,2,3,4,5,6,7,8]', JSON '4');

-- Mengembalikan true.
SELECT JSON_CONTAINS(JSON '{"a": 1, "b": 2, "c": {"d": 4}}', JSON '1', '$.a');

-- Mengembalikan false.
SELECT JSON_CONTAINS(JSON '{"a": 1, "b": 2, "c": {"d": 4}}', JSON '2', '$.a');

-- Mengembalikan false. json_path tidak ada.
SELECT JSON_CONTAINS(JSON '{"a": 1}',JSON '2', '$.b');

-- Mengembalikan false. json_path tidak valid.
SELECT JSON_CONTAINS(JSON '{"a": 1}',JSON '2', 'b');

-- Mengembalikan NULL.
SELECT JSON_CONTAINS(JSON '{"a": 1}',NULL);

-- Mengembalikan NULL.
SELECT JSON_CONTAINS(NULL,JSON '1'); 

Fungsi terkait

`JSON_CONTAINS` merupakan fungsi JSON. Untuk informasi lebih lanjut, lihat fungsi JSON.