ARRAY_CONTAINS - Lekérdezési nyelv a Cosmos DB-ben (az Azure-ban és a Fabricben)

A ARRAY_CONTAINS függvény egy logikai értéket ad vissza, amely jelzi, hogy a tömb tartalmazza-e a megadott értéket. Egy objektum részleges vagy teljes egyezését a függvény logikai kifejezésével ellenőrizheti.

Szemantika

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

Arguments

	Description
array_expr	Tömbkifejezés.
expr	A tömbön belül keresendő kifejezés.
bool_expr	Logikai kifejezés, amely azt jelzi, hogy a keresésnek részleges egyezést () vagy teljes egyezést (truefalse) kell-e keresnie. Ha nincs megadva, az alapértelmezett érték a következő false: .

Visszatérési típusok

Logikai értéket ad vissza.

Példák

Ez a szakasz példákat tartalmaz a lekérdezési nyelv szerkezetének használatára.

A tömb példákat tartalmaz

Ebben a példában a függvény az ARRAY_CONTAINS értékek és objektumok tömbökben való jelenlétének ellenőrzésére szolgál.

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

Megjegyzések

• Ez a függvény egy tartományindex használatát használja. További információ: tartományindexek.