Quickstart: Lag din første graf i Microsoft Fabric

I denne quickstarten bruker du graf i Microsoft Fabric for å lage en enkel graf med to noder og én kant, og kjører deretter en spørring. Denne prosessen tar omtrent 15 minutter.

For en omfattende veiledning som dekker hele Adventure Works-datamodellen og mer avanserte scenarioer, se grafveiledningen.

Forutsetninger

Før du starter denne quickstarten, sjekk at:

  1. Du har tilgang til en Microsoft Fabric-kapasitet (F2 eller høyere) eller en Fabric-prøve.

  2. Grafen er tilgjengelig i ditt område.

  3. Du er medlem av et Fabric-arbeidsområde eller har tillatelse til å opprette elementer i arbeidsområdet. For mer informasjon, se Workspaces i Microsoft Fabric.

    Viktig!

    Tilgangshåndteringen av grafen er begrenset til arbeidsområdet som hoster den. Brukere utenfor arbeidsområdet kan ikke få tilgang til grafen. Brukere i arbeidsområdet som har tilgang til de underliggende dataene i lakehouse, kan modellere og spørre grafen.

Laste inn eksempeldata

For å lage grafen din, last først inn prøvedata i et lakehouse i Fabric-arbeidsområdet ditt.

Last ned eksempeldataene

  1. Gå til grafen i Microsoft Fabric GQL-eksempeldatasett på GitHub.

  2. Velg adventureworks_docs_sample.zip-filen og last den ned til din lokale maskin.

    Tips

    For å laste ned en fil fra GitHub, velg filen, og velg deretter ikonet Last ned råfil.

  3. Pakk ut den nedlastede adventureworks_docs_sample.zip-filen til en mappe på din lokale maskin.

    Tips

    I Filutforsker, høyreklikk på zip-filen og velg Pakk ut alt, og velg deretter en destinasjonsmappe.

Opprett et innsjøhus

  1. I Microsoft Fabric velger du arbeidsområdet der du vil lage innsjøhuset.
  2. Velg + Nytt element.
  3. Velg Lagre data>Lakehouse.
  4. Skriv inn et navn (for eksempel "AdventureWorksLakehouse"), fjern Lakehouse-skjema-alternativet , og velg Create.

Last inn dataene i tabeller

For denne quickstart trenger du bare to tabeller: adventureworks_customers og adventureworks_orders. Last opp hele mappen for eksempeldata, og last deretter bare disse to tabellene.

Note

Hele settet med eksempelfiler brukes i den fullstendige grafveiledningen. Du kan også bruke dem til å utforske mer informasjon på egenhånd.

  1. I hytta ved innsjøen, hold musepekeren over Filer, velg ellipsen (...), og velg deretter mappen Last opp>.
  2. Bla gjennom den utpakkede mappen og last den opp. Denne handlingen laster opp alle prøvedatafilene til hytta ved innsjøen.
  3. Utvid Filer og den opplastede mappen for å se undermappene. For denne hurtigstarten trenger du bare å laste to av dem som tabeller.
  4. Hold musepekeren over adventureworks_customers undermappen, velg ellipsen (...), og velg Last til tabeller>Ny tabell.
  5. Sett filtypen til parquet og velg Last inn.
  6. Gjenta steg 4-5 for adventureworks_orders undermappe.

Når du er ferdig, ser du de to tabellene under Tabeller i panelet til lakehouse Explorer.

Skjermbilde som viser adventureworks_customers og adventureworks_orders tabellene.

Opprette en grafmodell

  1. I ditt Microsoft Fabric arbeidsområde, velg + Nytt element.

  2. Skriv inn graf i søkeboksen, trykk Enter for å søke etter grafelementer, og velg Grafmodell. Alternativt, bla ned til Analyser og tren datagrafmodell>.

    Skjermbilde som viser den nye gjenstandsmenyen med mulighet til å velge Grafmodell.

  3. Skriv inn et navn på grafmodellen din, for eksempel AdventureWorksGraph, og velg Create.

Etter å ha laget grafmodellen, blir du tatt til grafvisningen hvor du kan se at standardmodusen er satt til Modell. Over de øverste båndene ser du knapper for Lagre, Hent data, Legg til node, Legg til kant og Slett.

Skjermbilde som viser standardvisningen av grafmodellen.

Legg til data i grafen din

For å legge til data i grafen din, følg disse trinnene i grafvisning:

  1. I øverste bånd, velg Hent data.

  2. Fra OneLake-katalogen, velg ditt innsjøhus med Adventure Works-dataene.

  3. Velg Legg til.

  4. Velg tabellene adventureworks_customers og adventureworks_orders , og velg deretter Last inn.

    Skjermbilde som viser hent data-dialogen med valgte tabeller.

Definer grafens struktur

Nå som dataene dine er lastet inn, definer grafens struktur ved å legge til noder og kanter. I denne hurtigstarten legger du til to nodetyper (Customer og Order) og én kanttype (purchases) for å modellere forholdet mellom kunder og deres bestillinger.

Legg til to noder

  1. I det øverste båndet, velg Legg til node.

  2. Konfigurer den første noden:

    • Nodeetikett: Customer
    • Kildetabell: adventureworks_customers
    • Nøkkel: CustomerID_K

    Skjermbilde som viser dialogboksen Legg til node i graf.

  3. Velg + Legg til egenskap, Legg til alle kolonner, og Anvend. Dette steget gjør alle kolonner i denne kildetabellen tilgjengelige som egenskaper for noden.

    Skjermbilde som viser dialogen for å legge til node i grafen med fire egenskaper.

  4. Velg Opprett. Du ser en node for Customer appear på graflerretet.

  5. Velg Legg til node igjen.

  6. Konfigurer den andre noden:

    • Nodeetikett: Order
    • Kildetabell: adventureworks_orders
    • Nøkkel: SalesOrderDetailID_K
  7. Velg + Legg til egenskap, Legg til alle kolonner, og Anvend. Dette steget gjør alle kolonner i denne kildetabellen tilgjengelige som egenskaper for noden.

  8. Velg Opprett.

Du har nå to noder, Customer og Order, synlige på graflerretet.

Skjermbilde som viser to nye noder på lerretet.

Legg til én kant

  1. I det øverste båndet, velg Legg til kant.

  2. Konfigurer kanten:

    • Edge-label:purchases
    • Kildetabell: adventureworks_orders
    • Opprinnelsesnode: Customer
    • Opprinnelsesnøkkel: CustomerID_FK
    • Målnode: Order
    • Målnøkkel: SalesOrderDetailID_K

    Skjermbilde som viser dialogboksen legg til kant.

  3. Velg + Legg til egenskap, Legg til alle kolonner, og Anvend. Dette steget gjør alle kolonner i denne kildetabellen tilgjengelige som egenskaper for kanten.

  4. Velg Opprett.

  5. I det øverste båndet, velg Lagre.

Du ser node- og kantetiketter i grafvisningslerretet.

Skjermbilde som viser den nye kanten mellom de to nodene på lerretet.

Dataen kan ta noen minutter å laste ferdig. Vent på at etiketten Data last is in progress viser Data load completed... før du går videre til neste seksjon.

Skjermbilde som viser bekreftelsesmeldingen om at datainnlasting er fullført.

Søk i grafen din

Kjør en GQL-spørring for å finne de fem største kundene etter antall bestillinger.

  1. I moduspanelet , velg Spørringsmodus .

  2. I øverste bånd, velg Query builder > Code editor.

    Skjermbilde som viser hvordan man velger spørringsmodus og kodeeditoren.

  3. Skriv inn følgende GQL-spørring i inndataboksen:

    MATCH (c:Customer)-[:purchases]->(o:`Order`)
    RETURN c.fullName AS customer_name, count(o) AS num_orders
    GROUP BY customer_name
    ORDER BY num_orders DESC
    LIMIT 5
    
  4. I øverste bånd velger du Kjør spørring. Du ser fem rader med kundenavn og antall bestillinger, sortert fra flest til færrest ordre.

    Skjermbilde som viser resultatet av å kjøre en GQL-spørring.

Gratulerer! Du opprettet din første graf i Microsoft Fabric og kjørte en spørring mot den.

Neste trinn