Azure Digital Twins-Abfragesprache

In diesem Artikel werden die Grundlagen der Abfragesprache und ihrer Funktionen beschrieben. Beachten Sie, dass im Mittelpunkt von Azure Digital Twins der Zwillingsgraph steht, der sich aus digitalen Zwillingen und Beziehungen zusammensetzt. Dieser Graph kann abgefragt werden, um Informationen zu den darin enthaltenen digitalen Zwillingen und Beziehungen abzurufen. Diese Abfragen werden in einer benutzerdefinierten SQL-ähnlichen Abfragesprache mit der Bezeichnung Azure Digital Twins-Abfragesprache geschrieben. Diese Sprache ähnelt der IoT Hub-Abfragesprache mit vielen vergleichbaren Features.

Ausführlichere Beispiele für die Abfragesyntax und zum Ausführen von Abfrageanforderungen finden Sie unter Abfragen des Zwillingsgraphen.

Informationen zu Abfragen

Sie können die Abfragesprache von Azure Digital Twins verwenden, um digitale Zwillinge gemäß folgender Aspekte abzurufen:

• Eigenschaften (einschließlich Tageigenschaften)
• Modelle
• Beziehungen
  • Eigenschaften der Beziehungen

Wenn Sie eine Abfrage aus einer Client-App an den Dienst senden möchten, verwenden Sie die Azure Digital Twins-Abfrage-API. Eine Möglichkeit, die API zu verwenden, ist durch eins der SDKs für Azure Digital Twins.

Referenzdokumentation

Die Referenz zur Abfragesprache finden Sie unter Referenz im linken Inhaltsverzeichnis der Azure Digital Twins-Dokumentation. Über die unten stehenden Links können Sie auch direkt zu den Referenzabschnitten wechseln:

• Klauseln
  • SELECT
  • FROM
  • MATCH
  • JOIN
  • WHERE
• Funktionen
• Operatoren
• Reservierte Schlüsselwörter

Hinweise zur Abfrage

Beachten Sie beim Schreiben von Abfragen für Azure Digital Twins Folgendes:

• Denken Sie an die Beachtung der Groß-/Kleinschreibung: Bei allen Azure Digital Twins-Abfragevorgängen wird die Groß-/Kleinschreibung beachtet. Verwenden Sie daher genau die in den Modellen definierten Namen. Wenn Eigenschaftennamen falsch oder in falscher Groß-/Kleinschreibung geschrieben werden, ist das Resultset leer, und es werden keine Fehler zurückgegeben.

• Einfache Anführungszeichen mit Escapezeichen versehen: Wenn Ihr Abfragetext ein einzelnes Anführungszeichen in den Daten enthält, muss das Anführungszeichen mit dem Escapezeichen \ versehen werden. Im folgenden Beispiel wird der Eigenschaftswert D'Souza verwendet:

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

Hinweis

Nachdem Sie eine Änderung an den Daten in Ihrem Graphen vorgenommen haben, kann eine Latenz von bis zu 10 Sekunden auftreten, bevor die Änderungen in Abfragen berücksichtigt werden.

Die DigitalTwins-API spiegelt Änderungen sofort wider. Wenn Sie also eine sofortige Antwort benötigen, verwenden Sie eine API-Anforderung (DigitalTwins GetById) oder einen SDK-Aufruf (GetDigitalTwin), um Zwillingsdaten zu erhalten, anstatt eine Abfrage durchzuführen.

Abfragen von historisierten Zwillingsdaten im Laufe der Zeit

Die Abfragesprache von Azure Digital Twins unterstützt nur das Abfragen des aktuellen Zustands Ihrer digitalen Zwillinge und Beziehungen.

Um Abfragen für historisierte Zwillingsdiagrammdaten auszuführen, die im Laufe der Zeit gesammelt wurden, verwenden Sie das Datenverlaufsfeature, um Ihre Azure Digital Twins-Instanz mit einem Azure Data Explorer-Cluster zu verbinden. Dadurch werden Graphupdates automatisch in Azure Data Explorer historisiert, wo sie mithilfe des Azure Digital Twins-Plug-Ins für Azure Data Explorer abgefragt werden können.

Nächste Schritte

Unter Abfragen des Zwillingsgraphen finden Sie Information zum Verfassen von Abfragen und Clientcodebeispiele.