IS_PRIMITIVE - Cosmos DB 中的查詢語言 （在 Azure 和 Fabric 中）

函 IS_PRIMITIVE 式會傳回布林值，指出指定運算式的類型是否為基本類型 （字串、布林值、數值或 Null）。

適用於 NoSQL 的 Azure Cosmos DB 系統函式，如果指定運算式的類型是基本類型 （字串、布林值、數值或 Null），則會傳回 true。

語法

IS_PRIMITIVE(<expr>)

Arguments

	Description
expr	任何表達式。

傳回類型

傳回布林運算式。

範例

本節包含如何使用此查詢語言建構的範例。

檢查值是否為原始值

在此範例中，函數 IS_PRIMITIVE 用於檢查各種值，以查看它們是否為基本值。

SELECT VALUE {
  isBooleanAPrimitive: IS_PRIMITIVE(true),
  isNumberAPrimitive: IS_PRIMITIVE(1),
  isStringAPrimitive: IS_PRIMITIVE("value"),
  isArrayAPrimitive: IS_PRIMITIVE([ "green", "red", "yellow" ]),
  isNullAPrimitive: IS_PRIMITIVE(null),
  isObjectAPrimitive: IS_PRIMITIVE({ "name": "Tecozow coat" }),
  isObjectStringPropertyAPrimitive: IS_PRIMITIVE({ "name": "Tecozow coat" }.name),
  isObjectBooleanPropertyAPrimitive: IS_PRIMITIVE({ "onSale": false }.onSale),
  isUndefinedAPrimitive: IS_PRIMITIVE({}.category)
}

[
  {
    "isBooleanAPrimitive": true,
    "isNumberAPrimitive": true,
    "isStringAPrimitive": true,
    "isArrayAPrimitive": false,
    "isNullAPrimitive": true,
    "isObjectAPrimitive": false,
    "isObjectStringPropertyAPrimitive": true,
    "isObjectBooleanPropertyAPrimitive": true,
    "isUndefinedAPrimitive": false
  }
]

備註

• 此功能受益於範圍索引的使用。 如需詳細資訊，請參閱 範圍索引。