Bagikan melalui


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.