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 oktober 2024 understøtter Notebook git-integration at bevare mapping-forholdet for det tilknyttede miljø ved synkronisering til nyt arbejdsområde, hvilket betyder, at når du commit-er notebooken og det tilknyttede miljø sammen til git-repo og synkroniserer det til et andet arbejdsområde, er den nyligt genererede notebook og miljøet bundet sammen. Denne opgradering påvirker eksisterende notebooks og afhængige miljøer, der er versioneret i git, det fysiske id for tilknyttet miljø i notebook-metadataindhold erstattes med et logisk id, og ændringen afspejles i den forskellige visning.

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 commiter notebook-elementet til Git-repoet, konverteres notebook-koden til et kildekodeformat i stedet for en standardfil .ipynb . 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 versionskontrol af både notesbøger og miljøelementer . Fabric Git-systemet håndterer kortlægningsforholdet, når notebooken og det tilknyttede miljø synkroniseres 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 nu det nye design af deployment pipeline. Den gamle brugerflade kan tilgås 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