Quickstart: Opret din første graf i Microsoft Fabric

I denne quickstart bruger du graf i Microsoft Fabric til at lave en grundlæggende graf med to noder og én kant, og derefter kører du en forespørgsel. Denne proces tager cirka 15 minutter.

For en omfattende tutorial, der dækker hele Adventure Works-datamodellen og mere avancerede scenarier, se graftutorialen.

Forudsætninger

Før du starter denne quickstart, skal du tjekke at:

  1. Du har adgang til en Microsoft Fabric-kapacitet (F2 eller bedre) eller en Fabric-prøveperiode.

  2. Grafen er tilgængelig i dit område.

  3. Du er medlem af et Fabric-arbejdsområde eller har tilladelse til at oprette elementer i arbejdsområdet. For mere information, se Workspaces i Microsoft Fabric.

    Vigtigt

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

Indlæs eksempeldata

For at oprette din graf skal du først indlæse prøvedata i et lakehouse i dit Fabric-arbejdsområde.

Hente eksempeldataene

  1. Gå til grafen i Microsoft Fabric GQL-eksempeldatasæt på GitHub.

  2. Vælg adventureworks_docs_sample.zip-filen og download den til din lokale maskine.

    Tips

    For at downloade en fil fra GitHub, vælg filen, og vælg derefter ikonet Download rå fil.

  3. Pak den downloadede adventureworks_docs_sample.zip-fil ud i en mappe på din lokale maskine.

    Tips

    I Stifinder højreklikker du på zip-filen og vælger Udpak alt, og vælg derefter en destinationsmappe.

Opret et lakehouse

  1. I Microsoft Fabric vælger du det arbejdsområde, hvor du vil oprette søhuset.
  2. Vælg + Nyt element.
  3. Vælg Lagre data>Lakehouse.
  4. Indtast et navn (for eksempel "AdventureWorksLakehouse"), ryd Lakehouse-skemaerne og vælg Opret dem.

Indlæs dataene i tabeller

Til denne quickstart behøver du kun to tabeller: adventureworks_customers og adventureworks_orders. Upload hele mappen med prøvedata, og indlæs derefter kun disse to tabeller.

Notat

Det fulde sæt af eksempelfiler bruges i den fulde grafvejledning. Du kan også bruge dem til selv at udforske yderligere data.

  1. I dit sommerhus skal du holde musen over Filer, vælge ellipsen (...), og derefter vælge Upload>og upload-mappe.
  2. Gennemse den udpakkede mappe og upload den. Denne handling uploader alle prøvedatafiler til dit søhus.
  3. Udvid Filer og den uploadede mappe for at se undermapperne. Til denne quickstart behøver du kun at indlæse to af dem som tabeller.
  4. Hold musen over adventureworks_customers undermappe, vælg ellipsen (...), og vælg Indlæs til tabeller>Ny tabel.
  5. Sæt filtypen til parquet og vælg Indlæs.
  6. Gentag trin 4-5 for den adventureworks_orders undermappe.

Når du er færdig, ser du de to tabeller under Tabeller i panelet Lakehouse Explorer.

Skærmbillede, der viser adventureworks_customers og adventureworks_orders tabellerne.

Opret en grafmodel

  1. I dit Microsoft Fabric arbejdsområde vælg + Nyt element.

  2. Indtast graf i søgefeltet, tryk Enter for at søge efter grafelementer, og vælg Grafinstans. Alternativt kan du scrolle ned til Analyze and train data Graph>instance.

    Skærmbillede, der viser den nye genstandsmenu med mulighed for at vælge Grafmodel.

  3. Indtast et navn til din grafmodel, såsom AdventureWorksGraph, og vælg Opret dem.

Efter at have oprettet grafmodellen, bliver du ført til grafvisningen, hvor du kan se, at standardtilstanden er sat til Model. På de øverste bånd ser du knapper til Gem,Få data, Tilføj node, Tilføj kant og Slet.

Skærmbillede, der viser standardvisningen af grafmodellen.

Tilføj data til din graf

For at tilføje data til din graf, følg disse trin i grafvisningen:

  1. I det øverste bånd skal du vælge Hent data.

  2. Fra OneLake-kataloget vælger du dit søhus med Adventure Works-dataene.

  3. Vælg Tilføj.

  4. Vælg adventureworks_customers og adventureworks_orders tabellerne, og vælg derefter Indlæs.

    Skærmbillede, der viser dialogen 'hent data' med udvalgte tabeller.

Definér din grafs struktur

Nu hvor dine data er indlæst, definerer du grafens struktur ved at tilføje noder og kanter. I denne quickstart tilføjer du to nodetyper (Customer og Order) og én edge-type (purchases) for at modellere forholdet mellem kunder og deres ordrer.

Tilføj to noder

  1. I det øverste bånd skal du vælge Tilføj node.

  2. Konfigurér den første node:

    • Node-label: Customer
    • Kildetabel: adventureworks_customers
    • Nøgle: CustomerID_K

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

  3. Vælg + Tilføj egenskab, Tilføj alle kolonner, og Anvend. Dette trin gør alle kolonner i denne kildetabel tilgængelige som egenskaber for noden.

    Skærmbillede, der viser dialogen tilføj node til grafen med fire egenskaber.

  4. Vælg Opret. Du ser en node for Customer dukke op på graflærredet.

  5. Vælg Tilføj node igen.

  6. Konfigurér den anden node:

    • Node-label: Order
    • Kildetabel: adventureworks_orders
    • Nøgle: SalesOrderDetailID_K

  7. Vælg + Tilføj egenskab, Tilføj alle kolonner, og Anvend. Dette trin gør alle kolonner i denne kildetabel tilgængelige som egenskaber for noden.

  8. Vælg Opret.

Du har nu to noder, Customer og Order, synlige på graflærredet.

Skærmbillede, der viser to nye noder på lærredet.

Tilføj en kant

  1. I det øverste bånd vælger du Tilføj kant.

  2. Konfigurér kanten:

    • Edge-label: purchases
    • Kildetabel: adventureworks_orders
    • Oprindelsesnode: Customer
    • Oprindelsesnøgle: CustomerID_FK
    • Målnode: Order
    • Målnøgle: SalesOrderDetailID_K

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

  3. Vælg + Tilføj egenskab, Tilføj alle kolonner, og Anvend. Dette trin gør alle kolonner i denne kildetabel tilgængelige som egenskaber for kanten.

  4. Vælg Opret.

  5. I det øverste bånd vælger du Gem.

Du kan se node- og kantmærkaterne i grafvisningslærredet.

Skærmbillede, der viser den nye kant mellem de to noder på lærredet.

Dataen kan tage et par minutter at færdiggøre indlæsningen. Vent på, at mærkningen Data load is in progress viser, at Data load er fuldført... før du går videre til næste sektion.

Skærmbillede viser bekræftelsesbeskeden om, at dataindlæsningen er fuldført.

Forespørg din graf

Kør en GQL-forespørgsel for at finde de fem største kunder efter ordreantal.

  1. I modepanelet skal du vælge Forespørgselstilstand .

  2. I det øverste bånd vælger du Query builder > Code editor.

    Skærmbillede, der viser, hvordan man vælger forespørgselstilstand og kodeeditoren.

  3. Indtast følgende GQL-forespørgsel i inputboksen:

    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 det øverste bånd vælger du Kør forespørgsel. Du ser fem rækker med kundenavne og deres ordreantal, sorteret fra flest til færrest ordrer.

    Skærmbillede, der viser resultatet af at køre en GQL-forespørgsel.

Tillykke! Du lavede din første graf i Microsoft Fabric og kørte en forespørgsel mod den.

Næste trin

  • Last updated on