azure_digital_twins_query_request プラグイン

適用対象: ✅Microsoft Fabric✅Azure データ エクスプローラー

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

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

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

構文

evaluateazure_digital_twins_query_request ( AdtInstanceEndpoint , AdtQuery )

構文規則について詳しく知る。

パラメーター

件名	タイプ	Required	説明
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 のデータ履歴統合機能を使用して、デジタル ツインのプロパティの更新を履歴化できます。 履歴付きツインの更新を表示する方法については、「 履歴ツインの更新を表示する」を参照してください。