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 tweelingen 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 Query uitvoeren op de tweelinggrafiek voor meer gedetailleerde voorbeelden van querysyntaxis en het uitvoeren van queryaanvragen.

Over de query's

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

• Eigenschappen (inclusief tag-eigenschappen)
• Modellen
• Relaties
  • Eigenschappen van de relaties

Als u een query vanuit een client-app 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 onder Verwijzing in de linkerinhoudsopgave voor de Documentatie van Azure Digital Twins. U kunt ook rechtstreeks naar de referentiesecties gaan via de onderstaande koppelingen:

• Componenten
  • SELECT
  • VAN
  • OVEREENKOMEN MET
  • JOIN
  • 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:

• Hoofdlettergevoeligheid onthouden: 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, is de resultatenset leeg en worden er geen fouten geretourneerd.

• Escape voor enkele aanhalingstekens: als de querytekst één aanhalingsteken in de gegevens bevat, moet het aanhalingsteken worden voorzien van een escape-teken 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 direct antwoord nodig hebt, gebruikt u een API-aanvraag (DigitalTwins GetById) of een SDK-aanroep (GetDigitalTwin) om dubbele gegevens op te halen in plaats van een query.

Query's uitvoeren op ge historiseerde dubbelgegevens 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 gegevens van historized dubbelgrafieken 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 uitvoeren op de tweelinggrafiek.