IS_ARRAY - Cosmos DB 中的查询语言

IS_ARRAY 函数返回一个布尔值,该值指示指定表达式的类型是否为数组。

一个 Azure Cosmos DB for NoSQL 系统函数,该函数返回一个布尔值,指示表达式是否为数组。

Syntax

IS_ARRAY(<expr>)

Arguments

Description
expr 任何表达式。

返回类型

返回布尔表达式。

例子

本部分包含有关如何使用此查询语言构造的示例。

检查值是否为数组

在此示例中,该 IS_ARRAY 函数用于检查各种类型的对象。

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

注解

  • 此函数受益于范围索引的使用。 有关详细信息,请参阅 范围索引