Graph Sorgu Dili (GQL) (önizleme)

Sürüm açılan listesini kullanarak hizmetler arasında geçiş yapın. Gezinti hakkında daha fazla bilgi edinin.
Şunlar için geçerlidir: ✅ Microsoft Fabric ✅ Azure Veri Gezgini

Graph Sorgu Dili (GQL), standartlaştırılmış graf desen eşleştirmesini kullanmanıza olanak tanır. GQL, graf veritabanı sorguları için ISO GQL standardını izler.

Uyarı

GQL desteği önizleme aşamasındadır. Özellikler ve söz dizimi, geri bildirime ve sürekli geliştirmeye göre değişebilir.

Giriş

Graph Sorgu Dili (GQL), graf veritabanlarını sorgulamak için yeni ortaya çıkan bir ISO standardıdır. GQL, grafik deseni eşleştirmesi için SQL benzeri söz dizimini kullanmanıza olanak tanır, böylece verilerinizdeki ilişkileri analiz etmek daha kolay olur. Bu makalede GQL'nin nasıl kullanılacağı, avantajları ve temel özellikleri açıklanmaktadır.

GQL, ISO standart söz dizimini kullanarak verilerinizdeki ilişkileri analiz etmek için standartlaştırılmış grafik deseni eşleştirme özellikleri sağlar.

Başlangıç Yapmak

GQL kullanmak için şunları yapmanız gerekir:

Grafik modeli veya grafik yapma işleciyle biten geçici bir graf döndüren bir işlev olan graf veri kaynağı (bkz. 1. adım).
Belirli istemci isteği özelliklerini ayarlayın (bkz. 2. adım).

1. Adım: Grafik başvurusu oluşturma

GQL'yi kullanmadan önce bir graf veri kaynağı oluşturun. Bu makalede bellek içi graf işleci kullanılır, ancak üretim senaryoları için grafik anlık görüntüsü kullanmanızı öneririz.

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

2. Adım: İstemci isteği özelliklerini yapılandırma

GQL sorgularını çalıştırmak için üç istemci isteği özelliği ayarlayın. Bu özellikleri SDK, API aracılığıyla veya yönergeleri kullanarak doğrudan Kusto Gezgini veya Azure Veri Gezgini web kullanıcı arabiriminde ayarlayın.

GQL sorgularını çalıştırmak için üç istemci isteği özelliği ayarlayın. Bu özellikleri SDK, API veya yönergeleri kullanarak doğrudan Kusto Gezgini veya KQL sorgu kümesinde ayarlayın.

İstemci isteği özelliklerini ayarlama

Önemli

GQL sorgunuzu çalıştırmadan önce her yönergeyi ayrı ayrı çalıştırın. Yönergeler, GQL yürütmesi için sorgu ortamını ayarlar.

#crp query_language=gql

#crp query_graph_reference=G_doc()

GQL'de etiketleri kullanmak için etiket sütun adını ayarlayın:

#crp query_graph_label_name=lbl

Tip

Etiketler GQL'de isteğe bağlıdır, ancak genellikle düğümleri ve kenarları türe göre filtrelemek için kullanılır. GQL sorgularınızda etiketleri kullanmak için etiket sütun adını ayarlayın.

program aracılığıyla istemci isteği özelliklerini ayarlama

Programlı erişim için şu istemci isteği özelliklerini ayarlayın:

query_language: olarak "gql"ayarlayın.
query_graph_reference: Graf işlevi adınıza (örneğin, "G_doc()") ayarlayın.
query_graph_label_name: Etiket sütununuzun adı olarak ayarlayın (örneğin, "lbl").

3. Adım: GQL sorguları çalıştırma

Kurulumu tamamladıktan sonra standart GQL söz dizimlerini kullanarak GQL sorgularını çalıştırın. Temel ve gelişmiş GQL özelliklerini keşfetmek için aşağıdaki örnekleri kullanın.

Örnekler

Desen eşleştirme ve etiketler için temel örnekleri burada bulabilirsiniz. Daha karmaşık örnekler için bkz. GQL sorgu desenleri, örnekler ve yaygın senaryolar. Temel bilgiler ve işlev ayrıntıları da dahil olmak üzere başvuru belgeleri için bkz. Graph Sorgu Dili (GQL) başvurusu.

Temel desen eşleştirme için örnek GQL sorgusu

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

Çıkış

Aşağıdaki tabloda sorgunun sonucu gösterilmektedir.

CNT
20

Etiketlerle örnek GQL sorgusu

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