Referenz zur Azure Digital Twins-Abfragesprache: WHERE-Klausel

Dieses Dokument enthält Referenzinformationen zur WHERE-Klausel für die Azure Digital Twins-Abfragesprache.

Die WHERE-Klausel ist der letzte Teil einer Abfrage. Sie wird verwendet, um die zurückgegebenen Elemente nach bestimmten Bedingungen zu filtern.

Diese Klausel kann bei Abfragen optional genutzt werden.

Kernsyntax: WHERE

Die WHERE-Klausel wird zusammen mit einer booleschen Bedingung verwendet, um Abfrageergebnisse zu filtern.

Eine Bedingung kann eine Funktion sein, die zu einem booleschen Ergebnis ausgewertet wird. Sie können auch eine eigene boolesche Anweisung erstellen, indem Sie die Eigenschaften von Zwillingen und Beziehungen (über . zugänglich) mit einem Vergleichs- oder „contains-type“-Operator verwenden.

Syntax

Mit Eigenschaften und Operatoren:

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

Mit einer Funktion:

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

Argumente

Eine Bedingung, die zu einem Boolean-Wert ausgewertet wird.

Beispiele

Im folgenden Beispiel werden Eigenschaften und Operatoren verwendet. Die folgende Abfrage gibt in der WHERE-Klausel an, nur den Zwilling mit dem $dtId-Wert „Room1“ zurückzugeben.

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

Im folgenden Beispiel wird eine Funktion verwendet. Die folgende Abfrage verwendet die Funktion IS_OF_MODEL, um in der WHERE-Klausel anzugeben, nur die Zwillinge mit dem Modell dtmi:sample:Room;1 zurückzugeben. Weitere Informationen zur Funktion IS_OF_MODEL finden Sie unter Referenz zur Azure Digital Twins-Abfragesprache: Funktionen.

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