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.

Bemærk

Fra og med oktober 2024 understøtter git-integration af notesbøger, at tilknytningsrelationen for det tilknyttede miljø bevares, når der synkroniseres til nyt arbejdsområde, hvilket betyder, at når du sender notesbogen og det tilknyttede miljø sammen til git-lageret og synkroniserer det med et andet arbejdsområde, bindes den nyoprettede notesbog og det nye miljø sammen. Denne opgradering vil have indflydelse på eksisterende notesbøger og afhængige miljøer, der er versionsstyring i git. Det fysiske id for det vedhæftede miljø i notesbogmetadataindholdet erstattes med et logisk id. Ændringen afspejles i sammenligningsvisningen.

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.

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:

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.

Bemærk

• Filer i notesbogressourcer er i øjeblikket ikke bekræftet i lageret. Bekræftelse af disse filer understøttes i en kommende version.
• Vi anbefaler, at du administrerer notesbøgerne og deres afhængige miljø i det samme arbejdsområde og bruger Git til at styre både notesbog- og miljøelementer . Fabric Git-systemet håndterer tilknytningsrelationen, når du synkroniserer notesbogen og det tilknyttede miljø til nye arbejdsområder.
• 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.

Bemærk

• Du bruger det nye design af udrulningspipelinen nu. Du kan få adgang til den gamle brugergrænseflade ved at slå 'Ny udrulningspipeline' fra.
• Fra oktober understøtter Fabric-notesbogen automatisk bindingsfunktion, der binder standard lakehouse-miljøet og det tilknyttede miljø i det samme arbejdsområde, når der udrulles til næste fase. Ændringen påvirker eksisterende notesbøger i udrulningspipelinen.
  • Standard lakehouse-miljøet og det tilknyttede miljø (når alle afhængige elementer er i det samme arbejdsområde) erstattes af nyligt genererede elementer i målarbejdsområdet. Ændringen af notesbogens metadata fremhæves i sammenligningsvisningen i næste udrulningsrunde.
  • Du kan angive udrulningsregler for standard lakehouse for at tilsidesætte det automatisk bundne lakehouse.
• Kendt problem: Fastfrosset cellestatus i notesbogen går tabt under udrulningen. Vi arbejder i øjeblikket på relaterede opgaver.

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. Det fremhævede badge, der angiver antallet af ændrede elementer mellem den forrige fase og den aktuelle fase.

   

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.

   

   Fabric understøtter parameterisering af standard lakehouse for hver notesbogforekomst, når der udrulles med udrulningsregler. Der er tre muligheder til at angive destinationens standard lakehouse: Samme med kilde lakehouse, N/A(ingen standard lakehouse) og andet 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 angiver standard lakehouse i udrulningsregler, skal Lakehouse-id'et have. Du kan hente lakehouse-id'et fra elementets URL-link. Udrulningsreglerne har højere prioritet end automatisk binding. Det automatisk bindende lakehouse overskrives, når der er konfigureret en udrulningsregel.

6. Overvåg installationsstatussen fra installationshistorikken.

Relateret indhold

• Administrer og udfør Fabric-notesbøger med offentlige API'er
• Introduktion til Git-integration
• Introduktion til udrulningspipelines