Azure Digital Twins frågespråk

  • Artikel
  • 2 minuter för att läsa

I den här artikeln beskrivs grunderna i frågespråket och dess funktioner. Kom ihåg att mitten av 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 tvillingarna och relationerna som det 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. Ett sätt att använda API:et är via en av DEDK: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 den Azure Digital Twins dokumentationen. Du kan också gå direkt till referensavsnitten med hjälp av länkarna nedan:

Överväganden för frågor

När du skriver frågor Azure Digital Twins bör du tänka på följande:

  • Kom ihåg känslighet för Azure Digital Twins alla frågor är fallkänsliga, så var noga med att använda de exakta namn som definierats i modellerna. Om egenskapsnamn är felstavade eller felaktigt fallerade är resultatuppsättningen tom utan att några fel returneras.

  • Escape-enkla citattecken: Om frågetexten innehåller ett enkelt citattecken i data måste citattecknet vara rymt med \ tecknet . Här är ett exempel som hanterar egenskapsvärdet 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ågorna.

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.

Nästa steg

Lär dig hur du skriver frågor och ser exempel på klientkod i Fråga tvillingdiagrammet.