IS_ARRAY - Linguagem de consulta no Cosmos DB (no Azure e no Fabric)

A IS_ARRAY função retorna um valor booleano indicando se o tipo da expressão especificada é uma matriz.

Uma função de sistema do Azure Cosmos DB para NoSQL que retorna um booleano indicando se uma expressão é uma matriz.

Sintaxe

IS_ARRAY(<expr>)

Arguments

	Description
expr	Qualquer expressão.

Tipos de devolução

Retorna uma expressão booleana.

Examples

Esta seção contém exemplos de como usar essa construção de linguagem de consulta.

Verifique se o valor é array

Neste exemplo, a IS_ARRAY função é usada para verificar objetos de vários tipos.

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

Observações

• Esta função beneficia da utilização de um índice de intervalo. Para obter mais informações, consulte Índices de intervalo.