azure_digital_twins_query_request plugin-program

Gäller för: ✅Microsoft Fabric✅Azure Data Explorer

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

Med hjälp av plugin-programmet kan du fråga mellan 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ågeprogrammet.

Syntax

evaluate azure_digital_twins_query_request ( AdtInstanceEndpoint,AdtQuery)

Läs mer om syntaxkonventioner.

Parameterar

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 åtminstone beviljas rollen Azure Digital Twins-dataläsare . Information om hur du tilldelar den här rollen finns i Security for Azure Digital Twins-lösningar.

Exempel

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')

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

Utföra tidsserieanalys

Du kan använda datahistorikintegreringsfunktionen i Azure Digital Twins för att historisera uppdateringar av digital tvillingegenskap. Information om hur du visar historiserade tvillinguppdateringar finns i Visa historiserade tvillinguppdateringar