Azure Digital Twins języka zapytań: klauzula WHEREAzure Digital Twins query language reference: WHERE clause

Ten dokument zawiera informacje referencyjne dotyczące klauzuli WHERE dla Azure Digital Twins zapytań.This document contains reference information on the WHERE clause for the Azure Digital Twins query language.

Klauzula WHERE jest ostatnią częścią zapytania.The WHERE clause is the last part of a query. Służy do filtrowania elementów, które są zwracane na podstawie określonych warunków.It is used to filter the items that are returned based on specific conditions.

Ta klauzula jest opcjonalna podczas wykonywania zapytania.This clause is optional while querying.

Podstawowa składnia: WHERECore syntax: WHERE

Klauzula WHERE jest używana wraz z warunkiem logicznym do filtrowania wyników zapytania.The WHERE clause is used along with a Boolean condition to filter query results.

Warunek może być funkcją, która oblicza wynik logiczny.A condition can be a function that evaluates to a Boolean result. Możesz również utworzyć własną instrukcje logicznych przy użyciu właściwości bliźniaczych reprezentacji i relacji (dostępnych za pomocą funkcji ) za pomocą operatora porównania lub . typu zawiera.You can also create your own Boolean statement using the properties of twins and relationships (accessed with .) with a comparison or contains-type operator.

SkładniaSyntax

Za pomocą właściwości i operatorów:With properties and operators:

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

Za pomocą funkcji:With a function:

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

ArgumentyArguments

Warunek oceniania Boolean wartości.A condition evaluating to a Boolean value.

PrzykładyExamples

Oto przykład użycia właściwości i operatorów.Here is an example using properties and operators. Następujące zapytanie określa w klauzuli WHERE, aby zwrócić tylko bliźniacze reprezentacji z $dtId wartością Room1.The following query specifies in the WHERE clause to only return the twin with a $dtId value of Room1.

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

Oto przykład użycia funkcji.Here is an example using a function. Następujące zapytanie używa funkcji do określenia w klauzuli WHERE, aby zwrócić tylko bliźniacze reprezentacji IS_OF_MODEL z modelem dtmi:sample:Room;1 .The following query uses the IS_OF_MODEL function to specify in the WHERE clause to only return the twins with a model of dtmi:sample:Room;1. Aby uzyskać więcej informacji na IS_OF_MODEL temat funkcji, zobacz Azure Digital Twins języka zapytań: Funkcje.For more about the IS_OF_MODEL function, see Azure Digital Twins query language reference: Functions.

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