azure_digital_twins_query_request plugin-program

Plugin-programmet azure_digital_twins_query_request kör en Azure Digital Twins-fråga som en del av en Kusto-frågespråk -fråga (KQL). Plugin-programmet anropas med operatorn evaluate .

Med hjälp av plugin-programmet kan du köra frågor mot data i både Azure Digital Twins och alla datakällor som är tillgängliga via KQL. Du kan till exempel utföra tidsserieanalyser.

Mer information om plugin-programmet finns i Azure Digital Twins-frågeplugin för Azure Data Explorer.

Syntax

evaluateazure_digital_twins_query_request(AdtInstanceEndpoint,AdtQuery)

Läs mer om syntaxkonventioner.

Parametrar

Namn	Typ	Obligatorisk	Beskrivning
AdtInstanceEndpoint	string	✔️	Slutpunkten för Azure Digital Twins-instansen som ska efterfrågas.
AdtQuery	string	✔️	Frågan som ska köras mot Azure Digital Twins-slutpunkten. Den här frågan är skriven i ett anpassat SQL-liknande frågespråk för Azure Digital Twins, som kallas Azure Digital Twins-frågespråk. Mer information finns i Frågespråk för Azure Digital Twins.

Autentisering och auktorisering

Plugin-programmet azure_digital_twins_query_request använder Microsoft Entra kontot för användaren som kör frågan för att autentisera. Om du vill köra en fråga måste en användare minst beviljas rollen Azure Digital Twins-dataläsare . Information om hur du tilldelar den här rollen finns i Security for Azure Digital Twins solutions (Säkerhet för Azure Digital Twins-lösningar).

Exempel

I följande exempel visas hur du kan köra olika Azure Digital Twins-frågor, inklusive frågor som använder ytterligare Kusto-uttryck.

Hämtning av alla tvillingar i en Azure Digital Twins-instans

I följande exempel returneras alla digitala tvillingar i en Azure Digital Twins-instans.

evaluate azure_digital_twins_query_request(
  'https://contoso.api.wcus.digitaltwins.azure.net',
  'SELECT T AS Twins FROM DIGITALTWINS T')

Projektion av tvillingegenskaper som kolumner tillsammans med ytterligare Kusto-uttryck

I följande exempel returneras resultatet från plugin-programmet som separata kolumner och utför sedan ytterligare åtgärder med kusto-uttryck.

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

Resultat

TemperatureInC	Luftfuktighet
21	48
49	34
80	32

Utföra tidsserieanalys

Du kan använda integreringsfunktionen för datahistorik i Azure Digital Twins för att historisera uppdateringar av digital tvilling-egenskaper. Information om hur du visar historiserade tvillinguppdateringar finns i Visa historiserade tvillinguppdateringar i Azure Data Explorer