Delen via

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

  • Van toepassing op: ✅ Azure Cosmos DB, ✅ Cosmos DB in Microsoft Fabric

De ARRAY_CONTAINS_ANY functie retourneert een Booleaanse waarde die aangeeft of de matrix een van de opgegeven waarden bevat.

Syntaxis

ARRAY_CONTAINS_ANY(<array_expr>, <expr> [, exprN])

Arguments

Description
array_expr Een matrixexpressie.
expr Expressie om te zoeken in de matrix.
exprN Een of meer extra expressies om te zoeken in de matrix.

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_ANY functie gebruikt om te controleren op specifieke waarden of objecten in een matrix.

SELECT VALUE {
  matchesEntireArray: ARRAY_CONTAINS_ANY([1, true, "3", [1,2,3]], 1, true, "3", [1,2,3]),
  matchesSomeValues: ARRAY_CONTAINS_ANY([1, 2, 3, 4], 2, 3, 4, 5),
  matchSingleValue: ARRAY_CONTAINS_ANY([1, 2, 3, 4], 1, undefined),
  noMatches: ARRAY_CONTAINS_ANY([1, 2, 3, 4], 5, 6, 7, 8),
  emptyArray: ARRAY_CONTAINS_ANY([], 1, 2, 3),
  noMatchesUndefined: ARRAY_CONTAINS_ANY([1, 2, 3, 4], 5, undefined)
}

[
  {
    "emptyArray": false,
    "matchSingleValue": true,
    "matchesEntireArray": true,
    "matchesSomeValues": true,
    "noMatches": false
  }
]

Opmerking

In de bovenstaande undefined voorbeelden wordt deze gebruikt als zoekwaarde. Wanneer undefined wordt doorgegeven als argument, komt deze niet overeen met een waarde in de matrix. Alleen expliciet gedefinieerde waarden worden vergeleken.

Opmerkingen

  • Deze functie maakt geen gebruik van de index.
  • Last updated on