azure_digital_twins_query_request プラグイン

このプラグインはazure_digital_twins_query_request、Kusto 照会言語 (KQL) クエリの一部として Azure Digital Twins クエリを実行します。 このプラグインは、evaluate演算子*を使用して呼び出し*ます。

プラグインを使用すると、Azure Digital Twins と KQL を介してアクセスできる任意のデータ ソースの両方のデータに対してクエリを実行できます。 たとえば、 時系列分析を実行できます。

プラグインの詳細については、「Azure Data Explorer 用 Azure Digital Twins クエリ プラグイン」を参照してください。

構文

evaluateazure_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 ソリューションのセキュリティに関するページを参照してください。

例

次の例は、追加の Kusto 式を使用するクエリを含め、さまざまな 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 式も使用したツイン プロパティの列としてのプロジェクション

次の例では、プラグインの結果を個別の列として返した後に、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 のデータ履歴統合機能を使用して、デジタル ツインのプロパティの更新を履歴化できます。 履歴付きツインの更新プログラムを表示する方法については、「Azure Data Explorer で履歴付きツインの更新プログラムを表示する」を参照してください。