Azure Digital Twins querytaal

  • Artikel
  • 2 minuten om te lezen

In dit artikel worden de basisbeginselen van de querytaal en de mogelijkheden ervan beschreven. U herinnert zich misschien dat het Azure Digital Twins de tweelinggrafiekis, samengesteld uit digitale tweelingen en relaties. Deze grafiek kan worden opgevraagd om informatie op te halen over de digitale tweelingen 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's uitvoeren op de tweelinggrafiek voor meer gedetailleerde voorbeelden van querysyntaxis en het uitvoeren van queryaanvragen.

Over de query's

U kunt de querytaal Azure Digital Twins om digitale tweelingen 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 naslag voor querytaal vindt u onder Verwijzing in de inhoudsopgave links voor de Azure Digital Twins documentatie. U kunt ook rechtstreeks naar de referentiesecties gaan met behulp van de onderstaande koppelingen:

Overwegingen voor het uitvoeren van query's

Houd bij het schrijven van Azure Digital Twins rekening met de volgende overwegingen:

  • Onthoud de gevoeligheid van de case: alle Azure Digital Twins querybewerkingen zijn casegevoelig, dus zorg dat u de exacte namen gebruikt die in de modellen zijn gedefinieerd. Als de namen van eigenschappen verkeerd zijn gespeld of onjuist zijn gespeld, is de resultatenset leeg zonder dat er fouten worden geretourneerd.

  • Enkele aanhalingstekens escapen: als uw querytekst één aanhalingsteken in de gegevens bevat, moet het aanhalingsteken worden voorzien van een escape-teken. \ Hier is een voorbeeld van een eigenschapswaarde van D'Souza:

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

Notitie

Nadat u de gegevens in uw grafiek hebt gewijzigd, 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 dubbele gegevens op te halen in plaats van een query.

Volgende stappen

Meer informatie over het schrijven van query's en het bekijken van clientcodevoorbeelden in Query's uitvoeren op de tweelinggrafiek.