Graph Query Language (GQL) (preview)

Schakelen tussen services met behulp van de vervolgkeuzelijst Versie . Meer informatie over navigatie.
Van toepassing op: ✅ Microsoft Fabric ✅ Azure Data Explorer

Met Graph Query Language (GQL) kunt u gestandaardiseerde grafiekpatronen gebruiken. GQL volgt de ISO GQL-standaard voor grafiekdatabasequery's.

Introductie

Graph Query Language (GQL) is een opkomende ISO-standaard voor het uitvoeren van query's op grafiekdatabases. Met GQL kunt u SQL-achtige syntaxis gebruiken voor het vergelijken van grafiekpatronen, zodat u gemakkelijker relaties in uw gegevens kunt analyseren. In dit artikel wordt uitgelegd hoe u GQL, de voordelen en de belangrijkste functies ervan kunt gebruiken.

GQL biedt gestandaardiseerde mogelijkheden voor het vergelijken van grafiekpatronen voor het analyseren van relaties in uw gegevens met behulp van de ISO-standaardsyntaxis.

Aan de slag

Als u GQL wilt gebruiken, hebt u het volgende nodig:

• Een grafiekgegevensbron die een grafiekmodel of een functie is die een tijdelijke grafiek retourneert die eindigt op een make-graph-operator (zie stap 1).
• Specifieke eigenschappen voor clientaanvragen instellen (zie stap 2).

Stap 1: Een grafiekreferentie maken

Voordat u GQL gebruikt, maakt u een grafiekgegevensbron. In dit artikel wordt een in-memory make-graph-operator gebruikt, maar we raden u aan een grafiekmomentopname te gebruiken voor productiescenario's.

.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
}

Stap 2: Eigenschappen van clientaanvraag configureren

Eigenschappen van clientaanvraag instellen

#crp query_language=gql

#crp query_graph_reference=G_doc()

Als u labels in GQL wilt gebruiken, stelt u de naam van de labelkolom in:

#crp query_graph_label_name=lbl

Eigenschappen van clientaanvragen instellen in programmatisch

Stel deze eigenschappen voor clientaanvragen in voor programmatische toegang:

• query_language: Ingesteld op "gql".
• query_graph_reference: Stel deze in op de naam van de grafiekfunctie (bijvoorbeeld "G_doc()").
• query_graph_label_name: Stel deze in op de naam van de labelkolom (bijvoorbeeld "lbl").

Stap 3: GQL-query's uitvoeren

Nadat u de installatie hebt voltooid, voert u GQL-query's uit met behulp van de standaard-GQL-syntaxis. Gebruik de onderstaande voorbeelden om basis- en geavanceerde GQL-functies te verkennen.

Voorbeelden

Hier vindt u basisvoorbeelden voor patroonkoppeling en labels. Zie GQL-querypatronen, voorbeelden en algemene scenario's voor complexere voorbeelden. Zie de naslaginformatie over Graph Query Language (GQL) voor referentiedocumentatie, waaronder basisprincipes en functiedetails.

Voorbeeld van GQL-query voor basispatroonkoppeling

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

Uitvoer

In de volgende tabel ziet u het resultaat van de query.

Voorbeeld van GQL-query met labels

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

Uitvoer

In de volgende tabel ziet u het resultaat van de query.

Verwante inhoud

• GQL-verwijzing (Graph Query Language)
• GQL-querypatronen, voorbeelden en use cases
• Overzicht van Graph-operators
• make-graph-operator
• operator voor grafiekovereenkomsten
• Zelfstudie: Uw eerste grafiek maken
• Naslaginformatie over graph-functies