Referencia del lenguaje de consulta de Azure Digital Twins: cláusula WHERE

Este documento contiene información de referencia sobre la cláusula WHERE para el lenguaje de consulta de Azure Digital Twins.

La cláusula WHERE es la última parte de una consulta. Se usa para filtrar los elementos que se devuelven en función de condiciones específicas.

Esta cláusula es opcional durante la consulta.

Sintaxis principal: WHERE

La cláusula WHERE se usa junto con una condición booleana para filtrar los resultados de la consulta.

Una condición puede ser una función que se evalúa como un resultado booleano. También puede crear su propia instrucción booleana mediante las propiedades de los gemelos y las relaciones (a las que se accede con .) mediante un operador de comparación o de tipo contenido.

Sintaxis

Con propiedades y operadores:

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

Con una función:

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

Argumentos

Condición que se evalúa como un valor Boolean.

Ejemplos

Este es un ejemplo del uso de propiedades y operadores. La siguiente consulta especifica en la cláusula WHERE que solo se debe devolver el gemelo cuyo valor de $dtId sea Room1.

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

Este es un ejemplo del uso de una función. La consulta siguiente usa la función IS_OF_MODEL para especificar en la cláusula WHERE que solo se deben devolver los gemelos con un modelo de dtmi:sample:Room;1. Para obtener más información sobre la función IS_OF_MODEL, consulte la Referencia del lenguaje de consulta de Azure Digital Twins: Funciones.

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