Compartilhar via


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

A IS_DEFINED função retorna um booliano que indica se a propriedade recebeu um valor.

Uma função de sistema do Azure Cosmos DB para NoSQL que retornará true se a propriedade tiver recebido um valor.

Sintaxe

IS_DEFINED(<expr>)

Arguments

Description
expr Qualquer expressão.

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 a propriedade está definida

Neste exemplo, a IS_DEFINED função é usada para verificar a presença de uma propriedade em um documento JSON.

SELECT VALUE {
  isDefined: IS_DEFINED({ "quantity" : 5 }.quantity),
  isNotDefined: IS_DEFINED({ "quantity" : 5 }.name)
}
[
  {
    "isDefined": true,
    "isNotDefined": false
  }
]

Observações

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