Referência de linguagem de consulta de 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 de Gêmeos Digitais do Azure.

A cláusula WHERE é a última parte de uma consulta. Ela é usada para filtrar os itens retornados com base em condições específicas.

Essa cláusula é opcional durante a consulta.

Sintaxe principal: WHERE

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

Uma condição pode ser uma função que é avaliada como um resultado booliano. Você também pode criar sua própria instrução booliana usando as propriedades de gêmeos e relações (acessadas com .) com um operador de comparação ou contains-type.

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 que avalia como um valor Boolean.

Exemplos

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

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

Aqui está um exemplo usando uma função. A consulta a seguir usa a função IS_OF_MODEL 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 IS_OF_MODEL, consulte Referência de linguagem de consulta de Gêmeos Digitais do Azure: Funções.

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