Azure Digital Twins-querytaal

In dit artikel worden de basisbeginselen van de querytaal en de mogelijkheden ervan beschreven. Zoals u weet, is het centrum van Azure Digital Twins de tweelinggrafiek, samengesteld uit digitale dubbels en relaties. Deze grafiek kan worden opgevraagd om informatie op te halen over de digitale dubbels en relaties die deze bevat. Deze query's worden geschreven in een aangepaste SQL-achtige querytaal, die de Azure Digital Twins-querytaal wordt genoemd. Deze taal is vergelijkbaar met de IoT Hub-querytaal met veel vergelijkbare functies.

Zie querygrafiek voor gedetailleerdere voorbeelden van querysyntaxis en het uitvoeren van queryaanvragen.

Over de query's

U kunt de Azure Digital Twins-querytaal gebruiken om digitale dubbels op te halen op basis van hun...

• Eigenschappen (inclusief tageigenschappen)
• Modellen
• Relaties
  • Eigenschappen van de relaties

Als u vanuit een client-app een query naar de service wilt verzenden, gebruikt u de Azure Digital Twins Query-API. Een manier om de API te gebruiken, is via een van de SDK's voor Azure Digital Twins.

Referentiedocumentatie

De naslaginformatie over de querytaal vindt u in de linkeropgave van de inhoudsopgave voor de Documentatie van Azure Digital Twins. U kunt ook rechtstreeks naar de referentiesecties gaan met behulp van de onderstaande koppelingen:

• Clausules
  • SELECT
  • VAN
  • LUCIFER
  • VERBINDEN
  • WAAR
• Functies
• Operators
• Gereserveerde trefwoorden

Overwegingen voor het uitvoeren van query's

Houd bij het schrijven van query's voor Azure Digital Twins rekening met de volgende overwegingen:

• Onthoud hoofdlettergevoeligheid: alle Azure Digital Twins-querybewerkingen zijn hoofdlettergevoelig, dus zorg ervoor dat u de exacte namen gebruikt die in de modellen zijn gedefinieerd. Als eigenschapsnamen onjuist zijn gespeld of onjuist zijn gecased, is de resultatenset leeg zonder dat er fouten worden geretourneerd.

• Escape enkele aanhalingstekens: als uw querytekst één aanhalingsteken in de gegevens bevat, moet de aanhalingstekens worden ontsnapt met het \ teken. Hier volgt een voorbeeld dat betrekking heeft op een eigenschapswaarde van D'Souza:

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

Notitie

Nadat u een wijziging hebt aangebracht in de gegevens in uw grafiek, kan er een latentie van maximaal 10 seconden zijn voordat de wijzigingen worden doorgevoerd in query's.

De DigitalTwins-API weerspiegelt wijzigingen onmiddellijk, dus als u een direct antwoord nodig hebt, gebruikt u een API-aanvraag (DigitalTwins GetById) of een SDK-aanroep (GetDigitalTwin) om dubbelgegevens op te halen in plaats van een query.

Query's uitvoeren op historized twin-gegevens in de loop van de tijd

De Azure Digital Twins-querytaal is alleen bedoeld voor het uitvoeren van query's op de huidige status van uw digitale dubbels en relaties.

Als u query's wilt uitvoeren op historized twin graph-gegevens die in de loop van de tijd zijn verzameld, gebruikt u de functie gegevensgeschiedenis om uw Azure Digital Twins-exemplaar te verbinden met een Azure Data Explorer-cluster . Hiermee worden graafupdates automatisch historiseren naar Azure Data Explorer, waar ze kunnen worden opgevraagd met behulp van de Azure Digital Twins-invoegtoepassing voor Azure Data Explorer.

Volgende stappen

Meer informatie over het schrijven van query's en het bekijken van voorbeelden van clientcode in query's op de tweelinggrafiek.