Delen via


Broncodebeheer en implementatie van notebook

In dit artikel wordt uitgelegd hoe Git-integratie- en implementatiepijplijnen werken voor notebooks in Microsoft Fabric. Meer informatie over het instellen van een verbinding met uw opslagplaats, het beheren van uw notebooks en het implementeren ervan in verschillende omgevingen.

Git-integratie voor notebooks

Fabric-notebooks bieden Git-integratie voor broncodebeheer met Azure DevOps. Met Git-integratie kunt u een back-up maken van uw notebook en uw notebook versien, naar behoefte terugkeren naar eerdere fasen, samenwerken of alleen werken met behulp van Git-vertakkingen en de levenscyclus van uw notebookinhoud volledig beheren in Fabric.

Belangrijk

Deze functie is beschikbaar als preview-versie.

Een verbinding instellen

Vanuit uw werkruimte-instellingen kunt u eenvoudig een verbinding met uw opslagplaats instellen om wijzigingen door te voeren en te synchroniseren. Zie Aan de slag met Git-integratie om de verbinding in te stellen. Nadat u verbinding hebt gemaakt, worden uw items, inclusief notitieblokken, weergegeven in het configuratiescherm Bron .

Schermopname van het configuratiescherm van de werkruimtebron.

Nadat u de notebookexemplaren hebt doorgevoerd in de Git-opslagplaats, ziet u de mapstructuur van het notitieblok in de opslagplaats.

U kunt nu toekomstige bewerkingen uitvoeren, zoals pull-aanvraag maken.

Notitieblokweergave in Git

De volgende afbeelding is een voorbeeld van de bestandsstructuur van elk notitieblokitem in de opslagplaats:

Schermopname van de git-opslagplaatsstructuur van notebook.

Wanneer u het notebook-item doorvoert in de Git-opslagplaats, wordt de notebookcode geconverteerd naar een broncode-indeling in plaats van een standaard .ipynb-bestand. Een PySpark-notebook wordt bijvoorbeeld geconverteerd naar een notebook-content.py-bestand. Met deze aanpak kunt u eenvoudiger codebeoordelingen uitvoeren met behulp van ingebouwde diff-functies.

In het bestand met de inhoudsbron van het item blijven metagegevens (inclusief de standaardomgeving lakehouse en gekoppelde omgeving) markdown-cellen en codecellen behouden en onderscheiden. Deze benadering ondersteunt een nauwkeurig herstel wanneer u terug synchroniseert met een Infrastructuurwerkruimte.

Uitvoer van notebookcellen wordt niet opgenomen bij het synchroniseren met Git.

Schermopname van de git-opslagplaatsindeling van notebook.

Notitie

  • Op dit moment worden bestanden in Notebook-resources niet doorgevoerd in de opslagplaats. Het doorvoeren van deze bestanden wordt ondersteund in een toekomstige release.
  • De gekoppelde omgeving blijft behouden in een notebook wanneer u synchroniseert van opslagplaats naar een Infrastructuurwerkruimte. Op dit moment worden referentieomgevingen voor meerdere werkruimten niet ondersteund. U moet de standaardinstellingen voor een nieuwe omgeving of werkruimte handmatig koppelen om het notebook uit te voeren.
  • De standaard lakehouse-id blijft behouden in het notebook wanneer u van de opslagplaats naar een Infrastructuurwerkruimte synchroniseert. Als u een notitieblok doorvoert met het standaard lakehouse, moet u handmatig verwijzen naar een nieuw lakehouse-item. Zie De Git-integratie van Lakehouse voor meer informatie.

Notebook in implementatiepijplijnen

U kunt ook de implementatiepijplijn gebruiken om uw notebookcode in verschillende omgevingen te implementeren, zoals ontwikkeling, test en productie. Met deze functie kunt u uw ontwikkelingsproces stroomlijnen, kwaliteit en consistentie garanderen en handmatige fouten verminderen met lichtgewicht bewerkingen met weinig code. U kunt ook implementatieregels gebruiken om het gedrag van uw notebooks aan te passen wanneer ze worden geïmplementeerd, zoals het wijzigen van het standaard lakehouse van een notebook.

Belangrijk

Deze functie is beschikbaar als preview-versie.

Gebruik de volgende stappen om uw notebookimplementatie te voltooien met behulp van de implementatiepijplijn.

  1. Maak een nieuwe implementatiepijplijn of open een bestaande implementatiepijplijn. (Zie voor meer informatie Aan de slag met implementatiepijplijnen.)

  2. Wijs werkruimten toe aan verschillende fasen op basis van uw implementatiedoelen.

  3. Items selecteren, weergeven en vergelijken, inclusief notitieblokken tussen verschillende fasen, zoals wordt weergegeven in het volgende voorbeeld.

    Schermopname van notebook in implementatiepijplijn.

  4. Selecteer Implementeren om uw notebooks te implementeren in de fasen Ontwikkeling, Testen en Productie.

  5. (Optioneel.) U kunt implementatieregels selecteren om implementatieregels te maken voor een implementatieproces. Vermelding van implementatieregels bevindt zich in de doelfase voor een implementatieproces.

    Schermopname van het invoeren van implementatieregels.

    Fabric ondersteunt het parameteriseren van het standaard lakehouse voor elk notebookexemplaren bij het implementeren met implementatieregels. Er zijn drie opties beschikbaar om het standaard lakehouse van het doel op te geven: Hetzelfde als bron lakehouse, N/A (geen standaard lakehouse) en andere lakehouses.

    Schermopname van het instellen van standaard lakehouse.

    U kunt beveiligde gegevensisolatie bereiken door deze regel in te stellen. Het standaard lakehouse van uw notitieblok wordt vervangen door het notitieblok dat u tijdens de implementatie hebt opgegeven als doel.

    Notitie

    Wanneer u ervoor kiest om andere lakehouses in de doelomgeving te gebruiken, is Lakehouse-id een must. U vindt de id van een lakehouse via de URL-koppeling van lakehouse.

  6. Bewaak de implementatiestatus vanuit de implementatiegeschiedenis.