Delen via


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

De IS_ARRAY functie retourneert een Booleaanse waarde die aangeeft of het type van de opgegeven expressie een matrix is.

Een Systeemfunctie van Azure Cosmos DB die een Booleaanse waarde retourneert die aangeeft of een expressie een matrix is.

Syntaxis

IS_ARRAY(<expr>)

Arguments

Description
expr Elke expressie.

Retourtypen

Retourneert een Boole-expressie.

Voorbeelden

Deze sectie bevat voorbeelden van het gebruik van deze querytaalconstructie.

Controleren of de waarde matrix is

In dit voorbeeld wordt de IS_ARRAY functie gebruikt om objecten van verschillende typen te controleren.

SELECT VALUE {
  booleanIsArray: IS_ARRAY(true),
  numberIsArray: IS_ARRAY(65),
  stringIsArray: IS_ARRAY("AdventureWorks"),
  nullIsArray: IS_ARRAY(null),
  objectIsArray: IS_ARRAY({size: "small"}),
  arrayIsArray: IS_ARRAY([25344, 82947]),
  arrayObjectPropertyIsArray: IS_ARRAY({skus: [25344, 82947], vendors: null}.skus),
  invalidObjectPropertyIsArray: IS_ARRAY({skus: [25344, 82947], vendors: null}.size),
  nullObjectPropertyIsArray: IS_ARRAY({skus: [25344, 82947], vendors: null}.vendor)
}
[
  {
    "booleanIsArray": false,
    "numberIsArray": false,
    "stringIsArray": false,
    "nullIsArray": false,
    "objectIsArray": false,
    "arrayIsArray": true,
    "arrayObjectPropertyIsArray": true,
    "invalidObjectPropertyIsArray": false,
    "nullObjectPropertyIsArray": false
  }
]

Opmerkingen

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