azure_digital_twins_query_request プラグインは、Kusto 照会言語 (KQL) クエリの一部として Azure Digital Twins クエリを実行します。 このプラグインは、evaluate 演算子を使用して呼び出されます。
このプラグインを使用すると、Azure Digital Twins と KQL からアクセスできる任意のデータ ソースの両方のデータに対してクエリを実行できます。 たとえば、時系列分析のパフォーマンスをできます。
プラグインの詳細については、「 Azure Digital Twins クエリ プラグインを参照してください。
構文
evaluate
azure_digital_twins_query_request
(
AdtInstanceEndpoint,AdtQuery)
構文規則について詳しく知る。
パラメーター
| 件名 | タイプ | 必須 | 説明 |
|---|---|---|---|
| AdtInstanceEndpoint | string |
✔️ | クエリを実行する Azure Digital Twins インスタンス エンドポイント。 |
| AdtQuery | string |
✔️ | Azure Digital Twins エンドポイントに対して実行するクエリ。 このクエリは、Azure Digital Twins のカスタム SQL に似たクエリ言語 (Azure Digital Twins クエリ言語と呼ばれます) で記述されます。 詳細については、Azure Digital Twins 用のクエリ言語に関するページを参照してください。 |
認証と権限承認
azure_digital_twins_query_request プラグインは、クエリを実行しているユーザーの Microsoft Entra アカウントを使用して認証します。 クエリを実行するには、少なくとも Azure Digital Twins データ リーダー ロールがユーザーに付与されている必要があります。 このロールを割り当てる方法については、Azure Digital Twins ソリューションのセキュリティに関するページを参照してください。
例
次の例では、Azure Digital Twins インスタンス内のすべてのデジタル ツインが返されます。
evaluate azure_digital_twins_query_request(
'https://contoso.api.wcus.digitaltwins.azure.net',
'SELECT T AS Twins FROM DIGITALTWINS T')
次の例では、プラグインの結果を個別の列として返した後に、Kusto 式を使用して追加の操作を実行します。
evaluate azure_digital_twins_query_request(
'https://contoso.api.wcus.digitaltwins.azure.net',
'SELECT T.Temperature, T.Humidity FROM DIGITALTWINS T WHERE IS_PRIMITIVE(T.Temperature) AND IS_PRIMITIVE(T.Humidity)')
| where Temperature > 20
| project TemperatureInC = Temperature, Humidity
出力
| TemperatureInC | 湿度 |
|---|---|
| 21 (二十一) | 48 |
| 49 | 34 |
| 80 | 32 |
時系列分析を実行する
Azure Digital Twins のデータ履歴統合機能を使用して、デジタル ツインのプロパティの更新を履歴化できます。 履歴付きツインの更新を表示する方法については、「 履歴ツインの更新を表示する」を参照してください。