Styring og installation af notesbogkilde

I denne artikel forklares det, hvordan Git-integrations- og udrulningspipelines fungerer for notesbøger i Microsoft Fabric. Få mere at vide om, hvordan du konfigurerer en forbindelse til dit lager, administrerer dine notesbøger og udruller dem på tværs af forskellige miljøer.

Git-integration af notesbog

Fabric-notesbøger tilbyder Git-integration til kildestyring med Azure DevOps. Med Git-integration kan du sikkerhedskopiere og versionere din notesbog, vende tilbage til tidligere faser efter behov, samarbejde eller arbejde alene ved hjælp af Git-forgreninger og administrere din notesbogs indholdslivscyklus helt i Fabric.

Vigtigt

Denne funktion er en prøveversion.

Konfigurer en forbindelse

Fra indstillingerne for dit arbejdsområde kan du nemt konfigurere en forbindelse til dit lager for at bekræfte og synkronisere ændringer. Hvis du vil konfigurere forbindelsen, skal du se Kom i gang med Git-integration. Når du har oprettet forbindelse, vises dine elementer, herunder notesbøger, i kontrolpanelet Kilde.

Screenshot of workspace source control panel.

Når du har bekræftet forekomsterne af notesbogen til Git-lageret, kan du se notesbogmappestrukturen i lageret.

Du kan nu udføre fremtidige handlinger, f.eks . Opret pullanmodning.

Notesbogrepræsentation i Git

Følgende billede er et eksempel på filstrukturen for hvert notesbogelement i lageret:

Screenshot of notebook Git repo file structure.

Når du sender notesbogelementet til Git-lageret, konverteres notesbogkoden til et kildekodeformat i stedet for en .ipynb-standardfil. En PySpark-notesbog konverteres f.eks. til en notebook-content.py fil. Denne fremgangsmåde gør det nemmere at gennemse kode ved hjælp af indbyggede diff-funktioner.

I elementindholdskildefilen bevares og skelnes der mellem metadata (herunder standard lakehouse og tilknyttet miljø), Markdown-celler og kodeceller. Denne fremgangsmåde understøtter en præcis genoprettelse, når du synkroniserer tilbage til et Fabric-arbejdsområde.

Notesbogcelleoutput er ikke inkluderet, når der synkroniseres til Git.

Screenshot of notebook Git repo content format.

Bemærk

  • Filer i notesbogressourcer er i øjeblikket ikke bekræftet i lageret. Bekræftelse af disse filer understøttes i en kommende version.
  • Det tilknyttede miljø bevares i en notesbog, når du synkroniserer fra lager til et Fabric-arbejdsområde. Referencemiljøer på tværs af arbejdsområder understøttes i øjeblikket ikke. Du skal manuelt vedhæfte til et nyt miljø eller et nyt arbejdsområdes standardindstillinger i for at køre notesbogen.
  • Standard-lakehouse-id'et bevares i notesbogen, når du synkroniserer fra lageret til et Fabric-arbejdsområde. Hvis du bekræfter en notesbog med standardsøhuset, skal du henvise til et nyoprettet lakehouse-element manuelt. Du kan få flere oplysninger under Integration af Lakehouse Git.

Notesbog i udrulningspipelines

Du kan også bruge udrulningspipeline til at udrulle din notesbogkode på tværs af forskellige miljøer, f.eks. udvikling, test og produktion. Denne funktion kan gøre det muligt for dig at strømline din udviklingsproces, sikre kvalitet og ensartethed og reducere manuelle fejl med letvægtshandlinger med lav kode. Du kan også bruge udrulningsregler til at tilpasse funktionsmåden for dine notesbøger, når de udrulles, f.eks. ændre standardsøhuset for en notesbog.

Vigtigt

Denne funktion er en prøveversion.

Brug følgende trin til at fuldføre installationen af notesbogen ved hjælp af udrulningspipelinen.

  1. Opret en ny udrulningspipeline, eller åbn en eksisterende udrulningspipeline. (Du kan få flere oplysninger under Kom i gang med udrulningspipelines.)

  2. Tildel arbejdsområder til forskellige faser i henhold til dine udrulningsmål.

  3. Vælg, få vist og sammenlign elementer, herunder notesbøger mellem forskellige faser, som vist i følgende eksempel.

    Screenshot of notebook in deployment pipeline.

  4. Vælg Udrul for at udrulle dine notesbøger på tværs af faserne Udvikling, Test og Produktion.

  5. (Valgfrit). Du kan vælge Installationsregler for at oprette installationsregler for en udrulningsproces. Indtastning af installationsregler er på destinationsfasen for en udrulningsproces.

    Screenshot of deployment rules entry.

    Fabric understøtter parameterisering af standard lakehouse for hver notesbogforekomst, når der udrulles med udrulningsregler. Der er tre tilgængelige muligheder for at angive destinationens standard lakehouse: Samme med kildesøhus, I/T og andet lakehouse.

    Screenshot of set default lakehouse.

    Du kan opnå sikker dataisolation ved at konfigurere denne regel. Din notesbogs standard lakehouse erstattes af det, du angav som destination under udrulningen.

    Bemærk

    Når du vælger at adoptere andre lakehouses i målmiljøet, er Lakehouse ID et must have. Du kan finde id'et for et lakehouse fra linket til URL-adressen til lakehouse.

  6. Overvåg installationsstatussen fra installationshistorikken.