Aracılığıyla paylaş


Microsoft Fabric'te Graph için Hızlı Başlangıç Kılavuzu

Uyarı

Bu özellik şu anda genel önizlemededir. Bu önizleme, hizmet düzeyi sözleşmesi olmadan sağlanır ve üretim iş yükleri için önerilmez. Bazı özellikler desteklenmiyor olabileceği gibi özellikleri sınırlandırılmış da olabilir. Daha fazla bilgi için bkz. Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları.

Bu hızlı başlangıçta, Microsoft Fabric'te grafik modeli oluşturmayı öğreneceksiniz.

Önemli

Bu makalede yalnızca AdventureWorks örnek graf veri kümesi kullanılmaktadır.

Önkoşullar

Microsoft Fabric'te grafı kullanmaya başlamak için aşağıdaki önkoşullara ihtiyacınız vardır:

  • Graf bölgenizde kullanılabilir.

  • Graph, Fabric kiracınızda etkinleştirildi.

    Fabric kiracınızda grafı etkinleştirin.

  • OneLake'de analiz etmek istediğiniz verileri içeren bir göl evi. Bu hızlı başlangıçta örnek olarak Adventure Works verileri kullanılır. Verileriniz ve sonuçlarınız farklı olabilir. Göl uygulamanız yoksa şu adımları izleyerek bir tane oluşturun: OneLake ile bir göl evi oluşturun.

    Önemli

    Lakehouse şeması (önizleme) etkinleştirilmiş bir lakehouse kullanamazsınız.

  • Bir çalışma alanının üyesisiniz veya çalışma alanında öğe oluşturma izniniz var. Daha fazla bilgi için bkz. Microsoft Fabric'te çalışma alanları.

    Önemli

    Grafın erişim yönetimi, grafiği barındıran çalışma alanıyla sınırlıdır. Grafiğe çalışma alanı dışındaki kullanıcılar erişemez. Çalışma alanı içindeki lakehouse'daki temel verilere erişimi olan kullanıcılar grafı modelleyebilir ve sorgulayabilir.

Grafik modeli oluşturma

Microsoft Fabric'teki Graph, diğer Microsoft Fabric öğeleriyle aynı çalışma alanı rollerini kullanır. Aşağıdaki tabloda, grafik modellerindeki her Microsoft Fabric çalışma alanı rolünün özelliğiyle ilişkili izinler özetlemektedir.

Kapasite Admin Üye Katılımcı Görüntüleyici
Grafik modeli oluşturma veya değiştirme
Grafik modelini silme
Grafik modelinin içeriğini görüntüleme ve okuma
Graf modelini paylaşma

Microsoft Fabric'te grafik modeli oluşturmak için şu adımları izleyin:

  1. Microsoft Fabric çalışma alanınıza gidin.

  2. + Yeni öğe'yi seçin.

  3. Verileri analiz et ve eğit>Graf modelini (önizleme) seçeneğini belirleyin.

    Grafik modeli (önizleme) seçeneğinin gösterildiği yeni öğe menüsünü gösteren ekran görüntüsü.

    Tip

    Alternatif olarak, arama kutusuna "graf" yazın ve grafik öğelerini aramak için Enter tuşuna basın.

  4. Grafik modeliniz için bir ad girin ve Oluştur'u seçin.

Grafik oluşturma

Graf görünümünde Kaydet, Düğüm ekle ve Kenar ekle ve Veri al düğmelerini görmeniz gerekir.

Microsoft Fabric'te grafik oluşturmak için şu adımları izleyin:

  1. Grafik modelinizde Veri al'ı seçin.

  2. OneLake kataloğundan, grafiğinizde kullanmak üzere Doku'dan veri seçin.

    OneLake'te veri seçimi menüsünü gösteren ekran görüntüsü.

    Uyarı

    Bu hızlı başlangıçta örnek olarak Adventure Works verileri kullanılır. Veri kümeniz ve sonuçlarınız farklı olabilir.

  3. Ardından Bağlan'ı seçin.

  4. Veri tablolarını ve ardından Yükle'yi seçin.

  5. Grafiğinizde kullanılabilecek veriler görmeniz gerekir.

    Grafik modelindeki veri görünümünü gösteren ekran görüntüsü.

    Uyarı

    Microsoft Fabric'teki Graph şu anda aşağıdaki veri türlerini destekler:

    • Boole değeri (değerler true ve false)
    • Çift (değerler 64 bit kayan nokta sayılarıdır)
    • Tamsayı (değerler 64 bit işaretli tamsayılardır)
    • Dize (değerler Unicode karakter dizeleridir)
    • Zoned DateTime (değerler, saat dilimi için zaman kaymasıyla birlikte zaman damgalarıdır)

Modellemeyi başlatma

Artık grafiğe düğümler ve kenarlar ekleyerek modellemeye başlayabilirsiniz. Adventure Works veri modelini örnek olarak kullanırız.

Düğümler ekle

Bu bölümde Adventure Works veri modelindeki her varlık için düğümler oluşturacağız.

Düğüm etiketi Eşleme tablosu Eşleme sütunu
Müşteri customers CustomerID_K
Sipariş orders SalesOrderDetailID_K
Personel employees EmployeeID_K
Ürün products ProductID_K
Ürün Kategorisi ürün kategorileri CategoryID_K
ÜrünAltKategori ürün alt kategorileri SubcategoryID_K
Satıcı vendors VendorID_K

Düğümleri grafiğinize eklemek için şu adımları izleyin:

  1. Graf modelinizde, grafiğinize yeni bir düğüm eklemek için Düğüm ekle'yi seçin.

  2. Grafiğe düğüm ekle iletişim kutusunda bir Etiket adı girin ve uygun Eşleme tablosunu ve Eşleme sütununu seçin.

    Grafiğe düğüm ekle iletişim kutusunu gösteren ekran görüntüsü.

    Bu örnekte düğüm etiketi "Müşteri", eşleme tablosu "müşteriler", eşleme sütunu ise "CustomerID_K" şeklindedir.

  3. Düğümü grafınıza eklemek için Onayla'yı seçin.

  4. İşlemi diğer tüm düğümler için yineleyin. Grafiğinizde temsil edilen tüm düğümleri görmeniz gerekir.

  5. Grafiğinizi oluşturmaya başlamak için Kaydet'i seçin.

    Grafiğe eklenen tüm düğümleri gösteren ekran görüntüsü.

Kenarlar ekle

Bu bölümde, Adventure Works veri modelindeki düğümler arasındaki ilişkileri tanımlamak için kenarlar oluşturacağız.

Edge Eşleme tablosu Kaynak düğüm eşleme sütunu Hedef düğüm eşleme sütunu
Satıyor orders Personel

EmployeeID_FK
Sipariş

SalesOrderDetailID_K
Satınalmalar orders Müşteri

CustomerID_FK
Sipariş

SalesOrderDetailID_K
contains orders Sipariş

SalesOrderDetailID_K
Ürün

ProductID_FK
isOfType products Ürün

ProductID_K
ÜrünAltKategori

SubcategoryID_FK
belongsTo ürün alt kategorileri ÜrünAltKategori

SubcategoryID_K
Ürün Kategorisi

CategoryID_FK
Üretir satıcı ürünü Satıcı

VendorID_FK
Ürün

ProductID_FK

Grafınıza kenarları eklemek için şu adımları izleyin:

  1. Düğümler arasında bir ilişki oluşturmak için Kenar ekle seçin.

  2. Kenar ekle iletişim kutusunda eşleme tablosunu, kaynak ve hedef düğümleri seçin ve ilişkiyi tanımlayın.

    Kenar ekle iletişim kutusunu gösteren ekran görüntüsü.

    Bu örnekte kenar, "Siparişler" eşleme tablosuyla "satışlar" olarak tanımlanır ve "Çalışan" (EmployeeID_FK) kaynak düğümünü "Sipariş" (SalesOrderDetailID_K) hedef düğümüne bağlar.

  3. Kenarı grafınıza eklemek için Onayla'yı seçin.

  4. İşlemi diğer tüm kenarlar için tekrarlayın. Grafiğinizde gösterilen tüm kenarları görmeniz gerekir.

    Grafiğe eklenen tüm kenarları gösteren ekran görüntüsü.

Bu noktada, grafınız için tüm düğümleri ve kenarları oluşturdunuz. Graf modelinizin temel yapısı budur.

Grafiği yükleme

Grafiği yüklemek için Kaydet'i seçin. Bu işlem graf modelini doğrular, OneLake'ten veri yükler, grafı oluşturur ve sorgulamaya hazırlar.

Önemli

Şu anda model veya temel alınan veriler değiştirildiğinde grafiği yeniden yüklemeniz gerekir ( Kaydet'i seçerek).

Grafı sorgulama

Microsoft Fabric'teki Graph, diğer Microsoft Fabric öğeleriyle aynı çalışma alanı rollerini kullanır. Aşağıdaki çalışma alanı rolü izinleri, Graph Modeli veya QuerySet öğesi aracılığıyla sorgu çalıştırmanıza bağlı olarak geçerlidir.

Graf Modeli için çalışma alanı rolü izinleri

Kapasite Admin Üye Katılımcı Görüntüleyici
Grafik modeli oluşturma veya değiştirme
Grafik modelini silme
Grafik modelinin içeriğini görüntüleme ve okuma
Graf modelini paylaşma
Grafik sorguları oluşturma veya değiştirme
Graph QuerySet öğesi oluşturma veya değiştirme

Graph QuerySet için çalışma alanı rolü izinleri

Kapasite Admin Üye Katılımcı Görüntüleyici
Graph QuerySet öğesi oluşturma veya değiştirme
QuerySet öğesini sil
QuerySet öğesinin içeriğini görüntüleme ve okuma
Graf örneğine bağlanma
QuerySet'i Paylaş

Uyarı

Tüm kullanıcıların, başvuruda bulunılan grafik örneğine yönelik sorguları graph QuerySet öğesinden yürütmek için temel alınan grafik örneği öğesine okuma erişimine sahip olması gerekir. QuerySet öğesi için yalnızca okuma, yazma ve yeniden paylaşma izinleri desteklenir.

Sorgu oluşturucuyu kullanma

Artık belirli düğümleri ve ilişkileri seçerek grafı sorgulayabiliriz. Tüm sorgular, önceki bölümde oluşturduğumuz grafik yapısını temel alır...

Sorgu oluşturucuya geçmek ve grafınızı etkileşimli olarak sorgulamaya başlamak için şu adımları izleyin:

  1. Grafiğinizin giriş sayfasında Modlar>Sorgu oluşturucusu'nu seçin. Bu görünümden, aşağıdakiyle aynı işlevlere sahip olan ve sorgu sonuçlarınızı paylaşmanıza olanak tanıyan salt okunur bir sorgu kümesi de oluşturabilirsiniz.

  2. Sorgu için kullanılabilir düğümleri görmek için Düğüm ekle'yi seçin.

  3. Sorgunuza eklemek için bir düğüm seçin. Bu örnekte Müşteri düğümünü ekleyeceğiz.

    Sorgu modu seçimini gösteren ekran görüntüsü.

  4. Buradan düğümler ve kenarlar ekleyerek, filtreler uygulayarak ve sonuçlarda döndürülecek özellikleri seçerek sorgunuzu oluşturabilirsiniz.

Kod düzenleyicisini kullanma

Ayrıca GQL grafı sorgu dilini kullanarak grafı sorgulayabiliriz.

Kod düzenleyicisine geçmek ve GQL kullanarak grafınızı sorgulamaya başlamak için şu adımları izleyin:

  1. Grafiğinizin giriş sayfasında Mod Kodu>düzenleyicisi'ni seçin.
  2. Giriş alanına gibi MATCH (n:`Order`) RETURN count(n) AS num_ordersbir GQL sorgusu girin.
  3. Sorguyu yürütmek için Sorguyu çalıştır'ı seçin.

Eşleşen grafik desenlerini birleştiren sorgular, filtreleme, toplama, sıralama ve üst k sınırlama gibi daha karmaşık sorgular da çalıştırabilirsiniz:

MATCH (v:Vendor)-[:produces]->(p:`Product`)->(sc:`ProductSubcategory`)->(c:`ProductCategory`), 
      (o:`Order`)-[:`contains`]->(p)
FILTER c.categoryName = 'Components'
LET vendorName = v.vendorName, subCategoryName = sc.subCategoryName
RETURN vendorName, subCategoryName, count(p) AS num_products, count(o) AS num_orders
GROUP BY vendorName, subCategoryName
ORDER BY num_orders DESC
LIMIT 5

GQL dil desteği hakkında daha fazla bilgi için lütfen GQL dil kılavuzuna bakın.