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

Funktionen IS_ARRAY returnerar ett booleskt värde som anger om typen av det angivna uttrycket är en matris.

En Azure Cosmos DB-systemfunktion som returnerar ett booleskt värde som anger om ett uttryck är en matris.

Syntax

IS_ARRAY(<expr>)

Arguments

	Description
expr	Alla uttryck.

Returtyper

Returnerar ett booleskt uttryck.

Examples

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

Kontrollera om värdet är matris

I det här exemplet IS_ARRAY används funktionen för att kontrollera objekt av olika typer.

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

Anmärkningar

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