次の方法で共有


IS_ARRAY - Cosmos DB のクエリ言語 (Azure と Fabric)

IS_ARRAY関数は、指定した式の型が配列であるかどうかを示すブール値を返します。

式が配列であるかどうかを示すブール値を返す Azure Cosmos DB for NoSQL システム関数。

構文

IS_ARRAY(<expr>)

論争

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

注釈

  • この関数は、範囲インデックスを使用する利点があります。 詳細については、「 範囲インデックス」を参照してください。