ARRAY_CONTAINS - Abfragesprache in Cosmos DB (in Azure und Fabric)

Die ARRAY_CONTAINS Funktion gibt einen booleschen Wert zurück, der angibt, ob das Array den angegebenen Wert enthält. Sie können mithilfe eines booleschen Ausdrucks innerhalb der Funktion nach einer teilweisen oder vollständigen Übereinstimmung eines Objekts suchen.

Syntax

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

Arguments

	Description
array_expr	Ein Arrayausdruck.
expr	Ausdruck, nach dem innerhalb des Arrays gesucht werden soll.
bool_expr	Ein boolescher Ausdruck, der angibt, ob die Suche nach einer teilweisen Übereinstimmung (true) oder einer vollständigen Übereinstimmung (false) suchen soll. Wenn Sie hier nichts angeben, lautet der Standardwert false.

Rückgabetypen

Gibt einen booleschen Wert zurück.

Examples

Dieser Abschnitt enthält Beispiele für die Verwendung dieses Abfragesprachenkonstrukts.

Array enthält Beispiele

In diesem Beispiel wird die ARRAY_CONTAINS Funktion verwendet, um das Vorhandensein von Werten und Objekten in Arrays zu überprüfen.

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

Bemerkungen

• Diese Funktion profitiert von der Verwendung eines Bereichsindex. Weitere Informationen finden Sie unter Bereichsindizes.