ARRAY_CONTAINS - Bahasa kueri di Cosmos DB (di Azure dan Fabric)

Fungsi ARRAY_CONTAINS mengembalikan boolean yang menunjukkan apakah array berisi nilai yang ditentukan. Anda dapat memeriksa kecocokan sebagian atau penuh objek dengan menggunakan ekspresi boolean dalam fungsi.

Syntax

ARRAY_CONTAINS(<array_expr>, <expr> [, <bool_expr>])

Arguments

	Description
array_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.

Tipe pengembalian

Mengembalikan nilai boolean.

Examples

Bagian ini berisi contoh cara menggunakan konstruksi bahasa kueri ini.

Array berisi contoh

Dalam contoh ini, ARRAY_CONTAINS fungsi digunakan untuk memeriksa keberadaan nilai dan objek dalam array.

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
  }
]

Komentar

• Fungsi ini mendapat manfaat dari penggunaan indeks rentang. Untuk informasi selengkapnya, lihat indeks rentang.