ARRAY_CONTAINS – Frågespråk i Cosmos DB (i Azure och Fabric)

Funktionen ARRAY_CONTAINS returnerar ett booleskt värde som anger om matrisen innehåller det angivna värdet. Du kan söka efter en partiell eller fullständig matchning av ett objekt med hjälp av ett booleskt uttryck i funktionen.

Syntax

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

Arguments

	Description
array_expr	Ett matrisuttryck.
expr	Uttryck att söka efter i matrisen.
bool_expr	Ett booleskt uttryck som anger om sökningen ska söka efter en partiell matchning (true) eller en fullständig matchning (false). Om det inte anges är falsestandardvärdet .

Returtyper

Returnerar ett booleskt värde.

Examples

Det här avsnittet innehåller exempel på hur du använder den här frågespråkkonstruktionen.

Matrisen innehåller exempel

I det här exemplet ARRAY_CONTAINS används funktionen för att söka efter förekomst av värden och objekt i matriser.

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

Anmärkningar

• Den här funktionen drar nytta av användningen av ett intervallindex. Mer information finns i intervallindex.