azure_digital_twins_query_request-Plug-In
Gilt für: ✅Microsoft Fabric✅Azure Data Explorer
Das azure_digital_twins_query_request Plug-In führt eine Azure Digital Twins-Abfrage als Teil einer Kusto-Abfragesprache-Abfrage (KQL) aus. Das Plug-In wird mit dem evaluate Operator aufgerufen.
Mithilfe des Plug-Ins können Sie Daten in Azure Digital Twins und jeder Datenquelle abfragen, auf die über KQL zugegriffen werden kann. Sie können z. B. Zeitreihenanalysen durchführen.
Weitere Informationen zum Plug-In finden Sie unter Azure Digital Twins-Abfrage-Plug-In.
Syntax
evaluateazure_digital_twins_query_request ( AdtInstanceEndpoint , AdtQuery )
Erfahren Sie mehr über Syntaxkonventionen.
Parameter
| Name | Type | Erforderlich | Beschreibung |
|---|---|---|---|
| AdtInstanceEndpoint | string |
✔️ | Der Azure Digital Twins-Instanzendpunkt, der abgefragt werden soll. |
| AdtQuery | string |
✔️ | Die Abfrage, die für den Azure Digital Twins-Endpunkt ausgeführt werden soll. Diese Abfrage wird in einer benutzerdefinierten SQL-ähnlichen Abfragesprache für Azure Digital Twins geschrieben, die als Azure Digital Twins-Abfragesprache bezeichnet wird. Weitere Informationen finden Sie in der Abfragesprache für Azure Digital Twins. |
Authentifizierung und Autorisierung
Das azure_digital_twins_query_request Plug-In verwendet das Microsoft Entra-Konto des Benutzers, der die Abfrage zur Authentifizierung ausführt. Um eine Abfrage auszuführen, muss einem Benutzer mindestens die Azure Digital Twins Data Reader-Rolle gewährt werden. Informationen zum Zuweisen dieser Rolle finden Sie unter Sicherheit für Azure Digital Twins-Lösungen.
Beispiele
Die folgenden Beispiele zeigen, wie Sie verschiedene Azure Digital Twins-Abfragen ausführen können, einschließlich Abfragen, die zusätzliche Kusto-Ausdrücke verwenden.
Abrufen aller Zwillinge in einer Azure Digital Twins-Instanz
Im folgenden Beispiel werden alle digitalen Zwillinge in einer Azure Digital Twins-Instanz zurückgegeben.
evaluate azure_digital_twins_query_request(
'https://contoso.api.wcus.digitaltwins.azure.net',
'SELECT T AS Twins FROM DIGITALTWINS T')
Projektion von Zwillingseigenschaften als Spalten zusammen mit zusätzlichen Kusto-Ausdrücken
Das folgende Beispiel gibt das Ergebnis aus dem Plug-In als separate Spalten zurück und führt dann zusätzliche Vorgänge mithilfe von Kusto-Ausdrücken aus.
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
Output
| TemperatureInC | Feuchtigkeit |
|---|---|
| 21 | 48 |
| 49 | 34 |
| 80 | 32 |
Durchführen von Zeitreihenanalysen
Sie können die Datenhistorienintegrationsfunktion von Azure Digital Twins verwenden, um Updates digitaler Zwillinge zu historisieren. Informationen zum Anzeigen der historisierten Zwillingsupdates finden Sie unter "Anzeigen der historisierten Zwillingsupdates".