Azure Digital Twins クエリ言語リファレンス: WHERE 句

このドキュメントには、Azure Digital Twins クエリ言語の WHERE 句に関するリファレンス情報が含まれています。

WHERE 句は、クエリの最後の部分です。 特定の条件に基づいて返される項目をフィルター処理するために使用します。

この句はクエリの実行時に省略可能です。

コア構文: WHERE

WHERE 句は、クエリ結果をフィルター処理するブール値条件と共に使用します。

条件を関数にしてブール値結果を評価させることができます。 また、comparison または contains 型の演算子を使用したツインおよびリレーションシップ (. でアクセス) のプロパティを使用して、独自のブール ステートメントを作成することもできます。

構文

プロパティと演算子を使用する場合:

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

関数を使用する場合:

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

引数

Boolean 値に評価される条件。

例

プロパティと演算子を使用した例を次に示します。 次のクエリでは、$dtId 値が Room1 のツインのみを返すよう WHERE 句で指定しています。

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

関数を使用した例を次に示します。 次のクエリでは、IS_OF_MODEL 関数を使用して、モデルが dtmi:sample:Room;1 のツインのみを返すよう WHERE 句で指定しています。 IS_OF_MODEL 関数の詳細については、「Azure Digital Twins クエリ言語リファレンス: 関数」を参照してください。

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