Udostępnij przez

Przewodnik szybkiego startu dla Graph w Microsoft Fabric

Uwaga / Notatka

Ta funkcja jest obecnie w publicznej wersji zapoznawczej. Ta wersja zapoznawcza jest udostępniana bez umowy dotyczącej poziomu usług i nie jest zalecana w przypadku obciążeń produkcyjnych. Niektóre funkcje mogą nie być obsługiwane lub mogą mieć ograniczone możliwości. Aby uzyskać więcej informacji, zobacz Warunki dodatkowe korzystania z testowych wersji Microsoft Azure.

Z tego przewodnika Szybki start dowiesz się, jak utworzyć model grafu w usłudze Microsoft Fabric.

Ważne

W tym artykule jest używany wyłącznie przykładowy zestaw danych grafu AdventureWorks.

Wymagania wstępne

Aby rozpocząć pracę z grafem w usłudze Microsoft Fabric, potrzebne są następujące wymagania wstępne:

  • Wykres jest dostępny w Twoim regionie.

  • Usługa Graph jest włączona w Twojej dzierżawie Fabric.

    Włącz graf w dzierżawie Fabric.

  • Obiekt Lakehouse w usłudze OneLake zawierający dane, które chcesz przeanalizować. W tym przewodniku Szybki start dane firmy Adventure Works są używane jako przykład. Dane i wyniki mogą się różnić. Jeśli nie masz lakehouse, utwórz go, wykonując następujące kroki: Utwórz lakehouse za pomocą OneLake.

    Ważne

    Nie można użyć usługi Lakehouse z włączonym schematem lakehouse (wersja zapoznawcza).

  • Jesteś członkiem obszaru roboczego lub masz uprawnienia do tworzenia elementów w obszarze roboczym. Aby uzyskać więcej informacji, zobacz Obszary robocze w usłudze Microsoft Fabric.

    Ważne

    Zarządzanie dostępem do grafu jest ograniczone do obszaru roboczego, który go hostuje. Wykres nie jest dostępny dla użytkowników spoza obszaru roboczego. Użytkownicy w obszarze roboczym, którzy mają dostęp do podstawowych danych w Lakehouse, mogą modelować i wykonywać zapytania względem grafu.

Tworzenie modelu grafu

Program Graph w usłudze Microsoft Fabric używa tych samych ról obszaru roboczego co inne elementy usługi Microsoft Fabric. Poniższa tabela zawiera podsumowanie uprawnień skojarzonych z możliwościami poszczególnych ról obszaru roboczego usługi Microsoft Fabric w modelach grafów.

Capability Admin Członek Contributor Przeglądarka
Tworzenie lub modyfikowanie modelu grafu ✔ ✔ ✔ ✖
Usuwanie modelu grafu ✔ ✔ ✔ ✖
Wyświetlanie i odczytywanie zawartości modelu grafu ✔ ✔ ✔ ✔
Udostępnianie modelu grafu ✔ ✔ ✖ ✖

Aby utworzyć model grafu w usłudze Microsoft Fabric, wykonaj następujące kroki:

  1. Przejdź do obszaru roboczego usługi Microsoft Fabric.

  2. Wybierz pozycję + Nowy element.

  3. Wybierz pozycję Analizuj i wytrenuj dane>Model grafowy (wersja zapoznawcza).

    Zrzut ekranu przedstawiający menu nowego elementu z opcją wybrania modelu programu Graph (wersja zapoznawcza).

    Wskazówka

    Alternatywnie wprowadź ciąg "graph" w polu wyszukiwania i naciśnij Enter , aby wyszukać elementy grafu.

  4. Wprowadź nazwę modelu grafu i wybierz pozycję Utwórz.

Tworzenie grafu

W widoku grafu powinny być widoczne przyciski Zapisz, Dodaj węzeł i Dodaj krawędź oraz Pobierz dane .

Aby utworzyć graf w usłudze Microsoft Fabric, wykonaj następujące kroki:

  1. W modelu grafu wybierz pozycję Pobierz dane.

  2. Z katalogu OneLake wybierz dane z Fabric do wykorzystania na wykresie.

    Zrzut ekranu przedstawiający menu wyboru danych w usłudze OneLake.

    Uwaga / Notatka

    W tym przewodniku Szybki start dane firmy Adventure Works są używane jako przykład. Zestaw danych i wyniki mogą się różnić.

  3. Następnie wybierz pozycję Połącz.

  4. Wybierz tabele danych, a następnie wybierz pozycję Załaduj.

  5. Dane do użycia powinny być widoczne na wykresie.

    Zrzut ekranu przedstawiający widok danych w modelu grafu.

    Uwaga / Notatka

    Program Graph w usłudze Microsoft Fabric obsługuje obecnie następujące typy danych:

    • Typ logiczny (wartości to true i false)
    • Podwójne (wartości to 64-bitowe liczby zmiennoprzecinkowe)
    • Liczba całkowita (wartości to 64-bitowe liczby całkowite ze znakiem)
    • Ciąg (wartości to ciągi znaków Unicode)
    • Zoned DateTime (wartości to znaczniki czasu wraz ze zmianą czasu dla strefy czasowej)

Rozpoczynanie modelowania

Teraz możesz rozpocząć modelowanie, dodając węzły i krawędzie do grafu. Jako przykład używamy modelu danych Firmy Adventure Works.

Dodawanie węzłów

W tej sekcji utworzymy węzły dla każdej jednostki w modelu danych firmy Adventure Works.

Etykieta węzła Tabela mapowania Mapowanie kolumny
Klient customers CustomerID_K
Zamówienie orders SalesOrderDetailID_K (identyfikator szczegółu zamówienia sprzedaży)
Pracownik employees EmployeeID_K
Product products ProductID_K
Kategoria Produktu kategorie produktów CategoryID_K
ProduktPodkategoria podkategorie produktów SubcategoryID_K
Sprzedawca vendors VendorID_K

Aby dodać węzły do grafu, wykonaj następujące kroki:

  1. W modelu grafu wybierz pozycję Dodaj węzeł , aby dodać nowy węzeł do grafu.

  2. W oknie dialogowym Dodawanie węzła do grafu wprowadź nazwę etykiety i wybierz odpowiednią tabelę mapowania i kolumnę Mapowanie.

    Zrzut ekranu przedstawiający okno dialogowe dodawania węzła do grafu.

    W tym przykładzie etykieta węzła to "Klient", tabela mapowania to "customers", a kolumna mapowania to "CustomerID_K".

  3. Wybierz pozycję Potwierdź , aby dodać węzeł do grafu.

  4. Powtórz proces dla wszystkich innych węzłów. Wszystkie węzły powinny być widoczne na wykresie.

  5. Wybierz pozycję Zapisz , aby rozpocząć generowanie grafu.

    Zrzut ekranu przedstawiający wszystkie węzły dodane do grafu.

Dodaj krawędzie

W tej sekcji utworzymy krawędzie, aby zdefiniować relacje między węzłami w modelu danych firmy Adventure Works.

Edge Tabela mapowania Kolumna mapowania węzłów źródłowych Kolumna mapowania węzłów docelowych
Sprzedaje orders Pracownik

IDPracownika_FK		 Zamówienie

SalesOrderDetailID_K (identyfikator szczegółu zamówienia sprzedaży)
Zakupy orders Klient

CustomerID_FK		 Zamówienie

SalesOrderDetailID_K (identyfikator szczegółu zamówienia sprzedaży)
contains orders Zamówienie

SalesOrderDetailID_K (identyfikator szczegółu zamówienia sprzedaży)		 Product

ProductID_FK
isOfType products Product

ProductID_K		 Podkategoria Produktu

SubcategoryID_FK
należy do podkategorie produktów Podkategoria Produktu

SubcategoryID_K		 Kategoria Produktu

CategoryID_FK
Produkuje produkt dostawcy Sprzedawca

VendorID_FK		 Product

ProductID_FK

Aby dodać krawędzie do grafu, wykonaj następujące kroki:

  1. Wybierz pozycję Dodaj krawędź , aby utworzyć relację między węzłami.

  2. W oknie dialogowym Dodawanie krawędzi wybierz tabelę mapowania, węzły źródłowe i docelowe i zdefiniuj relację.

    Zrzut ekranu przedstawiający okno dialogowe dodawania krawędzi.

    W tym przykładzie krawędź jest definiowana jako "sells" i powiązana z tabelą mapowania "orders", co łączy węzeł źródłowy "Employee" (EmployeeID_FK) z węzłem docelowym "Order" (SalesOrderDetailID_K).

  3. Wybierz pozycję Potwierdź , aby dodać krawędź do grafu.

  4. Powtórz proces dla wszystkich innych krawędzi. Wszystkie krawędzie powinny być widoczne na wykresie.

    Zrzut ekranu przedstawiający wszystkie krawędzie dodane do grafu.

W tym momencie utworzono wszystkie węzły i krawędzie grafu. Jest to podstawowa struktura modelu grafu.

Ładowanie grafu

Aby załadować graf, wybierz pozycję Zapisz. Spowoduje to zweryfikowanie modelu grafu, załadowanie danych z usługi OneLake, skonstruowanie grafu i przygotowanie go do wykonywania zapytań.

Ważne

Obecnie musisz ponownie załadować graf (wybierając pozycję Zapisz) za każdym razem, gdy model lub bazowe dane są zmieniane.

Wykonywanie zapytań względem grafu

Program Graph w usłudze Microsoft Fabric używa tych samych ról obszaru roboczego co inne elementy usługi Microsoft Fabric. Następujące uprawnienia roli obszaru roboczego mają zastosowanie w zależności od tego, czy uruchamiasz zapytania za pośrednictwem elementu Graph Model lub QuerySet.

Uprawnienia roli w obszarze roboczym dla modelu grafu

Capability Admin Członek Contributor Przeglądarka
Tworzenie lub modyfikowanie modelu grafu ✔ ✔ ✔ ✖
Usuwanie modelu grafu ✔ ✔ ✔ ✖
Wyświetlanie i odczytywanie zawartości modelu grafu ✔ ✔ ✔ ✔
Udostępnianie modelu grafu ✔ ✔ ✖ ✖
Tworzenie lub modyfikowanie zapytań grafu ✔ ✔ ✔ ✖
Tworzenie lub modyfikowanie elementu zestawu zapytań grafu ✔ ✔ ✔ ✖

Uprawnienia roli obszaru roboczego dla zestawu zapytań programu Graph

Capability Admin Członek Contributor Przeglądarka
Tworzenie lub modyfikowanie elementu zestawu zapytań grafu ✔ ✔ ✔ ✖
Usuń element Zestawu zapytań ✔ ✔ ✔ ✖
Wyświetlanie i odczytywanie zawartości elementu QuerySet ✔ ✔ ✔ ✔
Nawiązywanie połączenia z wystąpieniem grafu ✔ ✔ ✔ ✖
Udostępnianie zestawu zapytań ✔ ✔ ✖ ✖

Uwaga / Notatka

Wszyscy użytkownicy potrzebują dostępu do odczytu do bazowego elementu wystąpienia grafu, aby wykonywać zapytania względem przywołytowanego wystąpienia grafu z elementu zestawu zapytań grafu. W przypadku elementu QuerySet są obsługiwane tylko uprawnienia do odczytu, zapisu i udostępniania dalej.

Korzystanie z konstruktora zapytań

Teraz możemy wykonywać zapytania względem grafu, wybierając określone węzły i relacje. Wszystkie zapytania są oparte na strukturze grafu, którą utworzyliśmy w poprzedniej sekcji.

Wykonaj następujące kroki, aby przełączyć się do konstruktora zapytań i rozpocząć interakcyjne wykonywanie zapytań względem grafu:

  1. Wybierz pozycję Tryby>Konstruktor zapytań na stronie głównej grafu. W tym widoku można również utworzyć zestaw zapytań tylko do odczytu, który ma takie same funkcje jak poniżej i umożliwia udostępnianie wyników zapytania.

  2. Wybierz pozycję Dodaj węzeł , aby wyświetlić dostępne węzły do wykonywania zapytań.

  3. Wybierz węzeł, aby dodać go do zapytania. W tym przykładzie dodamy węzeł Klient .

    Zrzut ekranu przedstawiający wybór trybu zapytania.

  4. W tym miejscu możesz skompilować zapytanie, dodając węzły i krawędzie, stosując filtry i wybierając właściwości, które mają być zwracane w wynikach.

Korzystanie z edytora kodu

Możemy również wykonywać zapytania względem grafu przy użyciu języka zapytań grafu GQL.

Wykonaj następujące kroki, aby przełączyć się do edytora kodu i rozpocząć wykonywanie zapytań względem grafu przy użyciu biblioteki GQL:

  1. Wybierz opcję Tryby>Edytor kodu na stronie głównej grafu.
  2. Wprowadź zapytanie GQL w polu wejściowym, na przykład MATCH (n:`Order`) RETURN count(n) AS num_orders.
  3. Wybierz pozycję Uruchom zapytanie , aby wykonać zapytanie.

Można również uruchamiać bardziej złożone zapytania, które łączą dopasowane wzorce grafu, filtrowanie, agregację, sortowanie i ograniczanie do najwyższych k wartości.

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

Aby uzyskać więcej informacji na temat obsługi języka GQL, zapoznaj się z przewodnikiem języka GQL.

Treści powiązane

  • Last updated on