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

A IS_NULL função retorna um valor booliano que indica se o tipo da expressão especificada é null.

Sintaxe

IS_NULL(<expr>)

Arguments

Tipos de retorno

Retorna uma expressão booliana.

Exemplos

Esta seção contém exemplos de como usar este constructo de linguagem de consulta.

Verificar 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

• Essa função se beneficia do uso de um índice de intervalo. Para obter mais informações, consulte índices de intervalo.