Frågespråk för Azure Digital Twins
I den här artikeln beskrivs grunderna i frågespråket och dess funktioner. Kom ihåg att centrum för Azure Digital Twins är tvillingdiagrammet, konstruerat från digitala tvillingar och relationer. Det här diagrammet kan efterfrågas för att få information om de digitala tvillingar och relationer som den innehåller. De här frågorna skrivs i ett anpassat SQL-liknande frågespråk, som kallas Azure Digital Twins-frågespråket. Det här språket liknar frågespråket IoT Hub med många jämförbara funktioner.
Mer detaljerade exempel på frågesyntax och hur du kör frågebegäranden finns i Fråga i tvillingdiagrammet.
Om frågorna
Du kan använda frågespråket Azure Digital Twins för att hämta digitala tvillingar enligt deras...
- Egenskaper (inklusive taggegenskaper)
- Modeller
- Relationer
- Egenskaper för relationerna
Om du vill skicka en fråga till tjänsten från en klientapp använder du Azure Digital Twins Query-API:et. Ett sätt att använda API:et är via en av SDK:erna för Azure Digital Twins.
Referensdokumentation
Referensen för frågespråk finns under Referens i den vänstra innehållsförteckningen för Azure Digital Twins-dokumentationen. Du kan också gå direkt till referensavsnitten med hjälp av länkarna nedan:
Överväganden vid frågor
Tänk på följande när du skriver frågor för Azure Digital Twins:
Kom ihåg skiftlägeskänslighet: Alla Azure Digital Twins-frågeåtgärder är skiftlägeskänsliga, så var noga med att använda de exakta namnen som definierats i modellerna. Om egenskapsnamnen är felstavade eller felaktigt skiftläge är resultatuppsättningen tom utan att några fel returneras.
Escape- enkla citattecken: Om frågetexten innehåller ett enda citattecken i data måste citattecknet undvikas med
\tecknet. Här är ett exempel som behandlar ett egenskapsvärde för D'Souza:SELECT * FROM DIGITALTWINS WHERE Name = 'D\'Souza'
Kommentar
När du har gjort en ändring av data i diagrammet kan det finnas en svarstid på upp till 10 sekunder innan ändringarna återspeglas i frågor.
DigitalTwins-API:et återspeglar ändringar omedelbart, så om du behöver ett omedelbart svar använder du en API-begäran (DigitalTwins GetById) eller ett SDK-anrop (GetDigitalTwin) för att hämta tvillingdata i stället för en fråga.
Köra frågor mot historiserade tvillingdata över tid
Azure Digital Twins-frågespråket är bara till för att fråga efter det aktuella tillståndet för dina digitala tvillingar och relationer.
Om du vill köra frågor på historiserade tvillingdiagramdata som samlats in över tid använder du funktionen för datahistorik för att ansluta din Azure Digital Twins-instans till ett Azure Data Explorer-kluster . Detta historiserar automatiskt grafuppdateringar till Azure Data Explorer, där de kan frågas med hjälp av Azure Digital Twins-plugin-programmet för Azure Data Explorer.
Nästa steg
Lär dig hur du skriver frågor och ser klientkodexempel i Fråga tvillingdiagrammet.