Frågespråk för Azure Digital Twins

Den här artikeln beskriver grunderna i frågespråket och dess funktioner. Kom ihåg att centrum för Azure Digital Twins är tvillingdiagrammet, konstruerat av 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 det IoT Hub frågespråket 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 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:

• Satser
  • SELECT
  • FRÅN
  • MATCHA
  • Ansluta sig till
  • DÄR
• Funktioner
• Operatorer
• Reserverade nyckelord

Överväganden för att fråga

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 definieras i modellerna. Om egenskapsnamnen är felstavade eller felaktigt skiftläge är resultatuppsättningen tom utan att några fel returneras.

• Undvik enkla citattecken: Om frågetexten innehåller ett enda citattecken i data måste citattecknet undantas från \ tecknet. Här är ett exempel som behandlar ett egenskapsvärde för D'Souza:

  SELECT * FROM DIGITALTWINS WHERE Name = 'D\'Souza'
  

Anteckning

När du har gjort en ändring av data i diagrammet kan det ta 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 köra frågor mot det aktuella tillståndet för dina digitala tvillingar och relationer.

Om du vill köra frågor om historiserade tvillingdiagramdata som samlas 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 klientkodsexempel i Fråga tvillingdiagrammet.