Referência da linguagem de consulta dos Gêmeos Digitais do Azure: cláusula WHERE

Este documento contém informações de referência sobre a cláusula WHERE para a linguagem de consulta dos Gêmeos Digitais do Azure.

A cláusula WHERE é a última parte de uma consulta. Ele é usado para filtrar os itens que são retornados com base em condições específicas.

Esta cláusula é opcional durante a consulta.

Sintaxe central: ONDE

A cláusula WHERE é usada junto com uma condição booleana para filtrar os resultados da consulta.

Uma condição pode ser uma função que avalia um resultado booleano. Você também pode criar sua própria instrução booleana usando as propriedades de gêmeos e relacionamentos (acessados com .) com um operador de comparação ou de tipo contém.

Sintaxe

Com propriedades e operadores:

--SELECT ...
--FROM ...
WHERE <twin-or-relationship-collection>.<property> <operator> <value-to-compare>

Com uma função:

--SELECT ...
--FROM ...
WHERE <function-with-Boolean-result>

Argumentos

Uma condição avaliando para um Boolean valor.

Exemplos

Aqui está um exemplo usando propriedades e operadores. A consulta a seguir especifica na cláusula WHERE para retornar apenas o gêmeo com um $dtId valor de Room1.

SELECT *
FROM DIGITALTWINS T
WHERE T.$dtId = 'Room1'

Aqui está um exemplo usando uma função. A consulta a seguir usa a IS_OF_MODEL função para especificar na cláusula WHERE para retornar apenas os gêmeos com um modelo de dtmi:sample:Room;1. Para obter mais informações sobre a função, consulte Referência de IS_OF_MODEL linguagem de consulta do Azure Digital Twins: Funções.

SELECT *
FROM DIGITALTWINS
WHERE IS_OF_MODEL('dtmi:sample:Room;1')