Graph Query Language (GQL) (Vorschau)

Wechseln Von Diensten mithilfe der Dropdownliste "Version ". Weitere Informationen zur Navigation.
Gilt für: ✅ Microsoft Fabric ✅ Azure Data Explorer

Mit graph Query Language (GQL) können Sie standardisierte Diagrammmusterabgleiche verwenden. GQL folgt dem ISO-GQL-Standard für Graphdatenbankabfragen.

Hinweis

Die GQL-Unterstützung befindet sich in der Vorschau. Features und Syntax können sich basierend auf Feedback und laufender Entwicklung ändern.

Einleitung

Graph Query Language (GQL) ist ein neuer ISO-Standard zum Abfragen von Diagrammdatenbanken. Mit GQL können Sie SQL-ähnliche Syntax für den Diagrammmusterabgleich verwenden, sodass es einfacher ist, Beziehungen in Ihren Daten zu analysieren. In diesem Artikel wird erläutert, wie Sie GQL, deren Vorteile und wichtige Features verwenden.

GQL bietet standardisierte Diagrammmustervergleichsfunktionen zum Analysieren von Beziehungen in Ihren Daten mithilfe der ISO-Standardsyntax.

Erste Schritte

Um GQL zu verwenden, benötigen Sie Folgendes:

Eine Diagrammdatenquelle, die entweder ein Diagrammmodell oder eine Funktion ist, die ein vorübergehendes Diagramm zurückgibt, das mit einem Make-Graph-Operator endet (siehe Schritt 1).
Festlegen bestimmter Clientanforderungseigenschaften (siehe Schritt 2).

Schritt 1: Erstellen eines Diagrammverweises

Erstellen Sie vor der Verwendung von GQL eine Diagrammdatenquelle. In diesem Artikel wird ein In-Memory-Make-Graph-Operator verwendet, es wird jedoch empfohlen, eine Graph-Momentaufnahme für Produktionsszenarien zu verwenden.

.create-or-alter function G_doc() {
    let nodes = datatable(id:string, lbl:string, name:string, properties:dynamic)
    [
        "p1","Person","Alice",dynamic({"age": 25}),
        "p2","Person","Bob",dynamic({"age": 30}),
        "p3","Person","Carol",dynamic({"age": 28}),
        "p4","Person","David",dynamic({"age": 35}),
        "p5","Person","Emma",dynamic({"age": 26}),
        "c1","Company","TechCorp",,
        "c2","Company","DataSoft",,
        "c3","Company","CloudInc",,
        "ct1","City","Seattle",,
        "ct2","City","Portland",,
        "ct3","City","San Francisco",
    ];
    let edges = datatable(source:string, target:string, lbl:string, since:int)
    [
        "p1","c1","works_at",2020,
        "p2","c1","works_at",2022,
        "p3","c2","works_at",2023,
        "p4","c3","works_at",2021,
        "p5","c1","works_at",2024,
        "p1","ct1","located_at",2019,
        "p2","ct1","located_at",2021,
        "p3","ct2","located_at",2022,
        "p4","ct3","located_at",2020,
        "p5","ct2","located_at",2023,
        "c1","ct1","located_at",2015,
        "c2","ct2","located_at",2018,
        "c3","ct3","located_at",2017,
        "p1","p2","knows",2019,
        "p2","p3","knows",2021,
        "p3","p4","knows",2022,
        "p4","p5","knows",2023,
        "p1","p4","likes",2020,
        "p4","p1","likes",2020,
        "p5","p2","likes",2022
    ];
    edges
    | make-graph source --> target with nodes on id
}

Schritt 2: Konfigurieren von Clientanforderungseigenschaften

Zum Ausführen von GQL-Abfragen legen Sie drei Clientanforderungseigenschaften fest. Legen Sie diese Eigenschaften über das SDK, die API oder direkt in der Kusto Explorer - oder Azure Data Explorer-Webbenutzeroberfläche mithilfe von Direktiven fest.

Zum Ausführen von GQL-Abfragen legen Sie drei Clientanforderungseigenschaften fest. Legen Sie diese Eigenschaften über das SDK, die API oder direkt im Kusto Explorer oder KQL-Abfrageset mithilfe von Direktiven fest.

Festlegen von Clientanforderungseigenschaften

Von Bedeutung

Führen Sie jede Direktive separat aus, bevor Sie die GQL-Abfrage ausführen. Die Direktiven richten die Abfrageumgebung für die GQL-Ausführung ein.

#crp query_language=gql

#crp query_graph_reference=G_doc()

Um Bezeichnungen in GQL zu verwenden, legen Sie den Bezeichnungsspaltennamen fest:

#crp query_graph_label_name=lbl

Tipp

Bezeichnungen sind in GQL optional, werden jedoch häufig verwendet, um Knoten und Kanten nach Typ zu filtern. Legen Sie den Bezeichnungsspaltennamen fest, um Bezeichnungen in Ihren GQL-Abfragen zu verwenden.

Programmgesteuertes Festlegen von Clientanforderungseigenschaften

Legen Sie für den programmgesteuerten Zugriff diese Clientanforderungseigenschaften fest:

query_language: Auf ."gql"
query_graph_reference: Legen Sie den Namen der Graph-Funktion fest (z. B "G_doc()". ).
query_graph_label_name: Legen Sie den Namen der Bezeichnungsspalte fest (z. B "lbl". ).

Schritt 3: Ausführen von GQL-Abfragen

Führen Sie nach Abschluss des Setups GQL-Abfragen mithilfe der standardmäßigen GQL-Syntax aus. Verwenden Sie die folgenden Beispiele, um grundlegende und erweiterte GQL-Features zu erkunden.

Examples

Hier finden Sie grundlegende Beispiele für Musterabgleich und Bezeichnungen. Komplexere Beispiele finden Sie unter GQL-Abfragemuster, Beispiele und gängige Szenarien. Referenzdokumentation, einschließlich Grundlagen und Funktionsdetails, finden Sie in der Referenz zur Graph-Abfragesprache (GQL).

Beispiel-GQL-Abfrage für den grundlegenden Musterabgleich

MATCH (n)-[e]->(n2)
RETURN COUNT(*) as CNT

Ausgabe

Die folgende Tabelle zeigt das Ergebnis der Abfrage.

CNT
20

Beispiel-GQL-Abfrage mit Bezeichnungen

MATCH (p:Person)-[e]->(target)
RETURN p.name, target.name, e.lbl
ORDER BY p.name, target.name
LIMIT 2