Dela via

Kontroll och distribution av notebook-källa

  • Artikel

Den här artikeln förklarar hur Git-integrerings- och distributionspipelines fungerar för notebook-filer i Microsoft Fabric. Lär dig hur du konfigurerar en anslutning till lagringsplatsen, hanterar dina notebook-filer och distribuerar dem i olika miljöer.

Git-integrering för notebook-fil

Fabric Notebooks erbjuder Git-integrering för källkontroll med Azure DevOps. Med Git-integrering kan du säkerhetskopiera och versionshantera din notebook-fil, återgå till tidigare steg efter behov, samarbeta eller arbeta ensam med Git-grenar och hantera livscykeln för notebook-innehåll helt i Fabric.

Viktigt!

Den här funktionen är i förhandsversion.

Konfigurera en anslutning

Från inställningarna för arbetsytan kan du enkelt konfigurera en anslutning till lagringsplatsen för att checka in och synkronisera ändringar. Information om hur du konfigurerar anslutningen finns i Kom igång med Git-integrering. När du är ansluten visas dina objekt, inklusive notebook-filer, på kontrollpanelen Källa.

Skärmbild av kontrollpanelen för arbetsytans källa.

När du har checkat in notebook-instanserna till Git-lagringsplatsen visas anteckningsbokens mappstruktur på lagringsplatsen.

Du kan nu köra framtida åtgärder, till exempel Skapa pull-begäran.

Notebook-representation i Git

Följande bild är ett exempel på filstrukturen för varje notebook-objekt på lagringsplatsen:

Skärmbild av git-lagringsplatsens filstruktur för notebook-filer.

När du checkar in notebook-objektet på Git-lagringsplatsen konverteras notebook-koden till ett källkodsformat i stället för en standard .ipynb-fil. Till exempel konverteras en PySpark-notebook-fil till en notebook-content.py fil. Den här metoden möjliggör enklare kodgranskningar med hjälp av inbyggda diff-funktioner.

I objektets innehållskällfil bevaras och särskiljs metadata (inklusive standard lakehouse och bifogad miljö), markdown-celler och kodceller. Den här metoden stöder en exakt återställning när du synkroniserar tillbaka till en Infrastruktur-arbetsyta.

Notebook-cellutdata ingår inte vid synkronisering till Git.

Skärmbild av git-lagringsplatsens innehållsformat för notebook-lagringsplats.

Kommentar

  • För närvarande checkas inte filer i Notebook-resurser in på lagringsplatsen. Incheckning av dessa filer stöds i en kommande version.
  • Den anslutna miljön finns kvar i en notebook-fil när du synkroniserar från lagringsplatsen till en infrastrukturresursarbetsyta. För närvarande stöds inte referensmiljöer för flera arbetsytor. Du måste ansluta till en ny miljö eller arbetsytans standardinställningar manuellt för att kunna köra notebook-filen.
  • Standard-Lakehouse-ID:t finns kvar i notebook-filen när du synkroniserar från lagringsplatsen till en Infrastruktur-arbetsyta. Om du checkar in en notebook-fil med standard lakehouse måste du referera till ett nyligen skapat lakehouse-objekt manuellt. Mer information finns i Lakehouse Git-integrering.

Notebook-fil i distributionspipelines

Du kan också använda distributionspipelinen för att distribuera din notebook-kod i olika miljöer, till exempel utveckling, test och produktion. Med den här funktionen kan du effektivisera utvecklingsprocessen, säkerställa kvalitet och konsekvens och minska manuella fel med enkla lågkodsåtgärder. Du kan också använda distributionsregler för att anpassa beteendet för dina notebook-filer när de distribueras, till exempel ändra standard lakehouse för en notebook-fil.

Viktigt!

Den här funktionen är i förhandsversion.

Följ stegen nedan för att slutföra distributionen av notebook-filen med hjälp av distributionspipelinen.

  1. Skapa en ny distributionspipeline eller öppna en befintlig distributionspipeline. (Mer information finns i Kom igång med distributionspipelines.)

  2. Tilldela arbetsytor till olika faser enligt dina distributionsmål.

  3. Välj, visa och jämför objekt inklusive notebook-filer mellan olika faser, som du ser i följande exempel.

    Skärmbild av notebook-filen i distributionspipelinen.

  4. Välj Distribuera för att distribuera dina notebook-filer i utvecklings-, test- och produktionsfaserna.

  5. (Valfritt.) Du kan välja Distributionsregler för att skapa distributionsregler för en distributionsprocess. Posten Distributionsregler är på målsteget för en distributionsprocess.

    Skärmbild av post för distributionsregler.

    Fabric stöder parameterisering av standard lakehouse för varje notebook-instans när du distribuerar med distributionsregler. Det finns tre alternativ för att ange standard lakehouse för målet: Samma med källsjöhus, N/A och annat sjöhus.

    Skärmbild av ange standard lakehouse.

    Du kan uppnå säker dataisolering genom att konfigurera den här regeln. Notebook-filens standard lakehouse ersätts av den som du angav som mål under distributionen.

    Kommentar

    När du väljer att införa andra sjöhus i målmiljön är Lakehouse-ID ett måste. Du hittar ID:t för ett sjöhus från länken till lakehouse-URL:en.

  6. Övervaka distributionsstatusen från distributionshistoriken.

Relaterat innehåll