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 Azure Cosmos DB for NoSQL-systeemfunctie 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.