ARRAY_CONTAINS - Querytaal in Cosmos DB (in Azure en Fabric)

De ARRAY_CONTAINS functie retourneert een Booleaanse waarde die aangeeft of de matrix de opgegeven waarde bevat. U kunt controleren op een gedeeltelijke of volledige overeenkomst van een object met behulp van een Booleaanse expressie binnen de functie.

Syntaxis

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

Arguments

	Description
array_expr	Een matrixexpressie.
expr	Expressie om te zoeken in de matrix.
bool_expr	Een Booleaanse expressie die aangeeft of de zoekopdracht moet controleren op een gedeeltelijke overeenkomst (true) of een volledige overeenkomst (false). Als dit niet is opgegeven, is falsede standaardwaarde .

Retourtypen

Retourneert een Booleaanse waarde.

Voorbeelden

Deze sectie bevat voorbeelden van het gebruik van deze querytaalconstructie.

Matrix bevat voorbeelden

In dit voorbeeld wordt de ARRAY_CONTAINS functie gebruikt om te controleren op de aanwezigheid van waarden en objecten in matrices.

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

Opmerkingen

• Deze functie profiteert van het gebruik van een bereikindex. Zie bereikindexen voor meer informatie.