Informations de référence sur le langage de requête Azure Digital Twins : clause WHERE

Ce document contient des informations de référence sur la clause WHERE du langage de requête Azure Digital Twins.

La clause WHERE est la dernière partie d’une requête. Elle est utilisée pour filtrer les éléments qui sont retournés en fonction de conditions spécifiques.

Cette clause est facultative lors de l’interrogation.

Syntaxe principale : WHERE

La clause WHERE est utilisée avec une condition booléenne pour filtrer les résultats de la requête.

Une condition peut être une fonction qui prend la valeur d’un résultat booléen. Vous pouvez également créer votre propre instruction booléenne en utilisant les propriétés de jumeaux et de relations (accessibles avec .) avec un opérateur de comparaison ou de type « contient ».

Syntaxe

Avec des propriétés et des opérateurs :

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

Avec une fonction :

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

Arguments

Condition prenant une valeur Boolean.

Exemples

Voici un exemple utilisant des propriétés et des opérateurs. La requête ci-dessous spécifie dans la clause WHERE de ne retourner que le jumeau dont la valeur $dtId est Room1.

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

Voici un exemple utilisant une fonction. La requête ci-dessous utilise la fonction IS_OF_MODEL pour spécifier, dans la clause WHERE, de ne retourner que les jumeaux ayant un modèle dtmi:sample:Room;1. Pour plus d’informations sur la fonction IS_OF_MODEL, consultez Informations de référence sur le langage de requête Azure Digital Twins : Fonctions.

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