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

A IS_NULL função retorna um valor booleano indicando se o tipo da expressão especificada é null.

Sintaxe

IS_NULL(<expr>)

Arguments

	Description
expr	Qualquer expressão para verificar se há null.

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 os valores são nulos

Neste exemplo, a IS_NULL função é usada para verificar vários tipos de valores nulos.

SELECT VALUE {
  booleanIsNull: IS_NULL(true),
  numberIsNull: IS_NULL(15),
  stringIsNull: IS_NULL("AdventureWorks"),
  nullIsNull: IS_NULL(null),
  objectIsNull: IS_NULL({price: 85.23}),
  arrayIsNull: IS_NULL(["red", "blue", "yellow"]),
  populatedObjectPropertyIsNull: IS_NULL({quantity: 25, vendor: null}.quantity),
  invalidObjectPropertyIsNull: IS_NULL({quantity: 25, vendor: null}.size),
  nullObjectPropertyIsNull: IS_NULL({quantity: 25, vendor: null}.vendor)
}

[
  {
    "booleanIsNull": false,
    "numberIsNull": false,
    "stringIsNull": false,
    "nullIsNull": true,
    "objectIsNull": false,
    "arrayIsNull": false,
    "populatedObjectPropertyIsNull": false,
    "invalidObjectPropertyIsNull": false,
    "nullObjectPropertyIsNull": true
  }
]

Observações

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