ARRAY_CONTAINS (kueri NoSQL)
BERLAKU UNTUK: NoSQL
Mengembalikan boolean yang menunjukkan apakah array berisi nilai yang ditentukan. Anda dapat memeriksa kecocokan sebagian atau penuh objek dengan menggunakan ekspresi boolean dalam fungsi.
Sintaks
ARRAY_CONTAINS(<array_expr>, <expr> [, <bool_expr>])
Argumen
Deskripsi | |
---|---|
arr_expr |
Ekspresi array. |
expr |
Ekspresi untuk dicari dalam array. |
bool_expr |
Ekspresi boolean yang menunjukkan apakah pencarian harus memeriksa kecocokan parsial (true ) atau kecocokan penuh (false ). Jika tidak ditentukan, nilai defaultnya adalah false . |
Jenis yang dikembalikan
Mengembalikan nilai boolean.
Contoh
Contoh berikut mengilustrasikan cara memeriksa nilai atau objek tertentu dalam array menggunakan fungsi ini.
SELECT VALUE {
containsItem: ARRAY_CONTAINS(["coats", "jackets", "sweatshirts"], "coats"),
missingItem: ARRAY_CONTAINS(["coats", "jackets", "sweatshirts"], "hoodies"),
containsFullMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shirts", color: "blue" }),
missingFullMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shirts" }),
containsPartialMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shirts" }, true),
missingPartialMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shorts", color: "blue" }, true)
}
[
{
"containsItem": true,
"missingItem": false,
"containsFullMatchObject": true,
"missingFullMatchObject": false,
"containsPartialMatchObject": true,
"missingPartialMatchObject": false
}
]
Keterangan
- Fungsi sistem ini mendapat manfaat dari indeks rentang.