azure_digital_twins_query_request-Plug-In

Das azure_digital_twins_query_request Plug-In führt eine Azure Digital Twins-Abfrage als Teil einer KQL-Abfrage (Kusto-Abfragesprache) aus. Das Plug-In wird mit dem evaluate Operator aufgerufen.

Mithilfe des Plug-Ins können Sie datenübergreifend sowohl in Azure Digital Twins als auch in jeder beliebigen Datenquelle abfragen, auf die über KQL zugegriffen werden kann. Beispielsweise können Sie Zeitreihenanalysen durchführen.

Weitere Informationen zum Plug-In finden Sie unter Azure Digital Twins-Abfrage-Plug-In für Azure Data Explorer.

Syntax

evaluateazure_digital_twins_query_request(AdtInstanceEndpoint,AdtQuery)

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name	Typ	Erforderlich	BESCHREIBUNG
AdtInstanceEndpoint	string	✔️	Der Azure Digital Twins-instance endpunkt, 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 unter 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 ausführt, um sich zu authentifizieren. Zum Ausführen einer Abfrage muss einem Benutzer mindestens die Rolle Azure Digital Twins-Datenleser zugewiesen 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-instance

Im folgenden Beispiel werden alle digitalen Zwillinge innerhalb einer Azure Digital Twins-instance 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

Im folgenden Beispiel wird das Ergebnis aus dem Plug-In als separate Spalten zurückgegeben, und anschließend werden zusätzliche Vorgänge mithilfe von Kusto-Ausdrücken ausgeführt.

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

Ausgabe

TemperatureInC	Luftfeuchtigkeit
21	48
49	34
80	32

Durchführen von Zeitreihenanalysen

Sie können das Datenverlaufsintegrationsfeature von Azure Digital Twins verwenden, um Aktualisierungen von Digitalen Zwillingseigenschaften zu historisieren. Informationen zum Anzeigen der Updates für historisierte Zwillinge finden Sie unter Anzeigen der Updates für historisierte Zwillinge in Azure Data Explorer