Del via

Hurtig startvejledning til Graph i Microsoft Fabric

Notat

Denne funktion er i øjeblikket tilgængelig som offentlig prøveversion. Denne prøveversion leveres uden en serviceniveauaftale og anbefales ikke til produktionsarbejdsbelastninger. Visse funktioner understøttes muligvis ikke eller kan have begrænsede funktioner. Du kan finde flere oplysninger under Supplerende vilkår for anvendelse af Microsoft Azure Previews.

I denne hurtige introduktion får du mere at vide om, hvordan du opretter en grafmodel i Microsoft Fabric.

Vigtigt

Denne artikel bruger udelukkende AdventureWorks eksempelgrafdatasæt.

Forudsætninger

Hvis du vil i gang med graf i Microsoft Fabric, skal du bruge følgende forudsætninger:

  • Graf er tilgængelig i dit område.

  • Graph er aktiveret i din Fabric-lejer:

    Aktivér graf i din Fabric-lejer.

  • Et søhus i OneLake med data, som du vil analysere. I denne hurtige start bruges Adventure Works-data som eksempel. Dine data og resultater kan variere. Hvis du ikke har et søhus, kan du oprette et ved at følge disse trin: Opret et søhus med OneLake.

    Vigtigt

    Du kan ikke bruge et søhus, der har lakehouse-skema (forhåndsversion) aktiveret.

  • Du er medlem af et arbejdsområde eller har tilladelse til at oprette elementer i arbejdsområdet. Du kan finde flere oplysninger under Arbejdsområder i Microsoft Fabric.

    Vigtigt

    Adgangsstyring af grafen er begrænset til det arbejdsområde, der huser den. Grafen er ikke tilgængelig for brugere uden for arbejdsområdet. Brugere i arbejdsområdet, som har adgang til de underliggende data i lakehouse, kan modellere og forespørge grafen.

Opret en grafmodel

Graph i Microsoft Fabric bruger de samme arbejdsområderoller som andre Microsoft Fabric-elementer. Følgende tabel opsummerer de tilladelser, der er forbundet med hver Microsoft Fabric-arbejdsområdes funktion på grafmodeller.

Egenskab Administrator Medlem Bidragyder Seer
Opret eller rediger grafmodel ✔ ✔ ✔ ✖
Slet grafmodel ✔ ✔ ✔ ✖
Se og læs indholdet af grafmodellen ✔ ✔ ✔ ✔
Del grafmodel ✔ ✔ ✖ ✖

Hvis du vil oprette en grafmodel i Microsoft Fabric, skal du følge disse trin:

  1. Gå til dit Microsoft Fabric-arbejdsområde.

  2. Vælg + Nyt element.

  3. Vælg Analysér og oplær datagrafmodel>(prøveversion).

    Skærmbillede, der viser den nye elementmenu med mulighed for at vælge Grafmodel (forhåndsvisning).

    Tips

    Alternativt kan du indtaste "graf" i søgefeltet og trykke på Enter for at søge efter grafelementer.

  4. Angiv et navn til din grafmodel, og vælg Opret.

Opret en graf

I grafvisning bør du se knapperne Gem, Tilføj node og Tilføj kant og Hent data .

Følg disse trin for at oprette en graf i Microsoft Fabric:

  1. I din grafmodel skal du vælge Hent data.

  2. Vælg data fra Fabric i OneLake-kataloget, der skal bruges i grafen.

    Skærmbillede, der viser datavalgsmenuen i OneLake.

    Notat

    I denne hurtige start bruges Adventure Works-data som eksempel. Dit datasæt og dine resultater kan variere.

  3. Vælg derefter Opret forbindelse.

  4. Vælg datatabeller, og vælg derefter Indlæs.

  5. Du bør se data, der er tilgængelige til brug i din graf.

    Skærmbillede, der viser datavisningen i grafmodellen.

    Notat

    Graph i Microsoft Fabric understøtter i øjeblikket følgende datatyper:

    • Boolesk (værdier er true og false)
    • Dobbelt (værdier er 64-bit tal med flydende tal)
    • Heltal (værdier er 64-bit fortegnede heltal)
    • Streng (værdier er Unicode-tegnstrenge)
    • Zoneinddelt datoklokkeslæt (værdier er tidsstempler sammen med et tidsforskydning for tidszonen)

Begynd at modellere

Nu kan du begynde at modellere ved at tilføje noder og kanter til grafen. Vi bruger Adventure Works-datamodellen som eksempel.

Tilføj noder

I dette afsnit opretter vi noder for hvert objekt i Adventure Works-datamodellen.

Node etiket Kortlægning tabel Kortlægning af kolonne
Debitor Kunder CustomerID_K
Ordre Ordrer SalesOrderDetailID_K
Medarbejder Medarbejdere EmployeeID_K
Product Produkter ProductID_K
ProductCategory Produktkategorier CategoryID_K
ProduktUnderkategori ProduktUnderkategorier SubcategoryID_K
Leverandør kreditorer VendorID_K

Følg disse trin for at føje noderne til din graf:

  1. I din grafmodel skal du vælge Tilføj node for at føje en ny node til din graf.

  2. I dialogboksen Føj node til graf skal du angive et etiketnavn og vælge den relevante tilknytningstabel og tilknytningskolonne.

    Skærmbillede, der viser dialogboksen Tilføj node til graf.

    I dette eksempel er nodeetiketten "Kunde", tilknytningstabellen er "kunder", og tilknytningskolonnen er "CustomerID_K".

  3. Vælg Bekræft for at føje noden til din graf.

  4. Gentag processen for alle andre noder. Du bør se alle de noder, der er repræsenteret i din graf.

  5. Vælg Gem for at begynde at generere din graf.

    Skærmbillede, der viser alle de noder, der er tilføjet til grafen.

Tilføj kanter

I dette afsnit opretter vi kanter for at definere relationerne mellem noderne i Adventure Works-datamodellen.

Edge Kortlægning tabel Kolonne til tilknytning af kildenoder Kolonne til tilknytning af målnoder
Sælger Ordrer Medarbejder

EmployeeID_FK		 Ordre

SalesOrderDetailID_K
Køb Ordrer Debitor

CustomerID_FK		 Ordre

SalesOrderDetailID_K
Indeholder Ordrer Ordre

SalesOrderDetailID_K		 Product

ProductID_FK
isOfType Produkter Product

ProductID_K		 ProduktUnderkategori

SubcategoryID_FK
tilhørerTil ProduktUnderkategorier ProduktUnderkategori

SubcategoryID_K		 ProductCategory

CategoryID_FK
Producerer Leverandør Produkt Leverandør

VendorID_FK		 Product

ProductID_FK

Følg disse trin for at føje kanterne til din graf:

  1. Vælg Tilføj kant for at oprette en relation mellem noder.

  2. I dialogboksen Tilføj kant skal du vælge tilknytningstabel, kilde- og destinationsnoder og definere relationen.

    Skærmbillede, der viser dialogboksen Tilføj kant.

    I dette eksempel defineres kanten som "sælger" med tilknytningstabellen "ordrer", der forbinder kildenoden "Medarbejder" (EmployeeID_FK) med målnoden "Ordre" (SalesOrderDetailID_K).

  3. Vælg Bekræft for at føje kanten til grafen.

  4. Gentag processen for alle andre kanter. Du bør se alle kanterne repræsenteret i din graf.

    Skærmbillede, der viser alle de kanter, der er tilføjet til grafen.

På dette tidspunkt oprettede du alle noder og kanter til din graf. Dette er den grundlæggende struktur i din grafmodel.

Indlæs grafen

For at indlæse grafen, vælg Gem. Dette vil verificere grafmodellen, indlæse data fra OneLake, konstruere grafen og gøre den klar til forespørgsler.

Vigtigt

Du skal i øjeblikket genindlæse grafen (ved at vælge Gem), hver gang modellen eller de underliggende data ændres.

Forespørg på grafen

Graph i Microsoft Fabric bruger de samme arbejdsområderoller som andre Microsoft Fabric-elementer. Følgende arbejdsområderolle-tilladelser gælder afhængigt af, om du kører forespørgsler via Graph Model eller QuerySet-elementet.

Workspace-rollerettigheder for Graph Model

Egenskab Administrator Medlem Bidragyder Seer
Opret eller rediger grafmodel ✔ ✔ ✔ ✖
Slet grafmodel ✔ ✔ ✔ ✖
Se og læs indholdet af grafmodellen ✔ ✔ ✔ ✔
Del grafmodel ✔ ✔ ✖ ✖
Opret eller ændr grafforespørgsler ✔ ✔ ✔ ✖
Oprette eller redigere graf QuerySet-element ✔ ✔ ✔ ✖

Workspace-rollerettigheder for Graph QuerySet

Egenskab Administrator Medlem Bidragyder Seer
Oprette eller redigere graf QuerySet-element ✔ ✔ ✔ ✖
Slet forespørgselssæt-element ✔ ✔ ✔ ✖
Få vist og læse indholdet af QuerySet-elementet ✔ ✔ ✔ ✔
Opret forbindelse til grafforekomst ✔ ✔ ✔ ✖
Del forespørgselssæt ✔ ✔ ✖ ✖

Notat

Alle brugere skal have læseadgang til det underliggende grafforekomstelement for at udføre forespørgsler mod den refererede grafforekomst fra grafforespørgselssættet. Det er kun tilladelser til læsning, skrivning og deling igen, der understøttes for QuerySet-elementet.

Brug af forespørgselsgeneratoren

Nu kan vi forespørge på grafen ved at vælge specifikke noder og relationer. Alle forespørgsler er baseret på den grafstruktur, som vi byggede i forrige afsnit.

Følg disse trin for at skifte til forespørgselsgenerator og begynde at forespørge på grafen interaktivt:

  1. Vælg Modes>Query builder fra grafens startside. Fra dette synspunkt kan du også oprette et skrivebeskyttet forespørgselssæt, som har de samme funktioner som nedenfor og giver dig mulighed for at dele dine forespørgselsresultater.

  2. Vælg Tilføj node for at se de tilgængelige noder til forespørgsler.

  3. Vælg en node for at føje den til forespørgslen. I dette eksempel tilføjer vi noden Kunde .

    Skærmbillede, der viser valget af forespørgselstilstand.

  4. Herfra kan du oprette din forespørgsel ved at tilføje noder og kanter, anvende filtre og vælge egenskaber, der skal returneres i resultaterne.

Brug af kodeeditoren

Vi kan også forespørge på grafen ved hjælp af GQL-grafforespørgselssproget.

Følg disse trin for at skifte til kodeeditor og begynde at forespørge på din graf ved hjælp af GQL:

  1. Vælg Editor til tilstandskode> fra din grafs startside.
  2. Indtast en GQL-forespørgsel i inputfeltet, f.eks MATCH (n:`Order`) RETURN count(n) AS num_orders. .
  3. Vælg Kør forespørgsel for at udføre forespørgslen.

Du kan også køre mere komplekse forespørgsler, f.eks. forespørgsler, der kombinerer matchende grafmønstre, filtrering, sammenlægning, sortering og top-k-begrænsning:

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

For yderligere information om GQL-sprogunderstøttelse, se venligst GQL-sprogguiden.

Relateret indhold

  • Last updated on