Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
In dit artikel wordt uitgelegd hoe u Git-integratie- en implementatiepijplijnen gebruikt met notebooks in Microsoft Fabric. U leert hoe u een opslagplaats verbindt, broncode van notebooks beheert en notebooks implementeert in omgevingen.
Voordat u begint
- Verbind uw werkruimte met Git voordat u de stappen voor broncodebeheer van notebooks voltooit. Zie Aan de slag met Git-integratie voor installatie-instructies.
- Maak notebookimplementatieregels in de doelfase (bijvoorbeeld Test of Productie), niet in Ontwikkeling.
- Als u implementatieregels wilt maken, moet u de eigenaar van het item zijn.
Git-integratie voor notebooks
Fabric-notebooks ondersteunen Git-integratie met Azure DevOps voor broncodebeheer. U kunt het versiebeheer van wijzigingen in notebooks doen, samenwerken via vertakkingen en het beheer van de levenscyclusupdates van notitieblokken rechtstreeks in Fabric uitvoeren.
Wanneer u een notebook samen met de gekoppelde afhankelijkheden (bijvoorbeeld omgevingen) doorvoert, behoudt synchronisatie met een andere werkruimte deze bindingen. Fabric verbindt het notebook automatisch met de bijbehorende resources in de nieuwe werkruimte.
Ter ondersteuning van dit gedrag slaat Fabric logische id's op voor gekoppelde resources in metagegevens van notebooks. Git-diffs kunnen daardoor updates in metagegevens weergeven van fysieke id's naar logische id's.
Notitie
Updates van metagegevens met betrekking tot logische id's en automatische binding kunnen worden weergegeven in Git-diff-weergaven, zelfs wanneer notitieblokcode niet wordt gewijzigd.
Een verbinding instellen
Stel vanuit werkruimte-instellingen een verbinding met uw opslagplaats in om wijzigingen door te voeren en te synchroniseren. Zie Aan de slag met Git-integratie voor installatie-instructies. Nadat u verbinding hebt gemaakt, worden uw items, inclusief notitieblokken, weergegeven in het Bronbeheer paneel.
Nadat u notebookexemplaren hebt doorgevoerd in de Git-opslagplaats, ziet u de mapstructuur van het notitieblok in de opslagplaats.
U kunt nu Git-bewerkingen uitvoeren, zoals pull-aanvraag maken.
Notebookweergave in Git
In de volgende tekst ziet u de bestandsstructuur voor een notitieblokitem in de Git-opslagplaats:
.
├── Notebook_1.Notebook/
│ ├── Resources/ (Optional)
│ │ └── builtin/
│ │ ├── large_dataset.parquet
│ │ └── model_output.parquet
│ ├── .platform
│ ├── fs-settings.json (Optional)
│ ├── notebook-content.py
│ └── notebook-settings.json (Optional)
└── Readme.md
.
├── Notebook_2.Notebook/
│ ├── Resources/ (Optional)
│ │ └── builtin/
│ │ ├── large_dataset.parquet
│ │ └── model_output.parquet
│ ├── .platform
│ ├── fs-settings.json (Optional)
│ ├── notebook-content.sql
│ └── notebook-settings.json (Optional)
└── Readme.md
Wanneer u een notitieblokitem doorvoert, slaat Fabric het op als bronbestanden in plaats van een standaard .ipynb-bestand. Een PySpark-notebook wordt bijvoorbeeld opgeslagen als notebook-content.py. Dit formaat is eenvoudiger te controleren in Git-diffs.
Het bronbestand bewaart metagegevens van notitieblokken (inclusief de standaard lakehouse- en gekoppelde omgeving), Markdown-cellen en codecellen als afzonderlijke secties. Fabric gebruikt deze structuur om het notebook te reconstrueren wanneer u terug synchroniseert met een werkruimte.
Uitvoer van notebookcellen wordt niet opgenomen bij het synchroniseren met Git.
In de volgende schermopname ziet u de bronindeling in de Git-opslagplaats:
Notitie
Houd notebooks en hun afhankelijke omgevingen in dezelfde werkruimte en beheer zowel notebooks als omgevingen in Git. Fabric brengt deze relaties in kaart bij het synchroniseren met nieuwe werkruimtes.
De standaard lakehouse-ID blijft in metagegevens van notebooks wanneer u vanuit de opslagplaats synchroniseert naar een Fabric-werkruimte. Koppel het notitieblok zo nodig handmatig aan het nieuwe lakehouse-item. Zie De Git-integratie van Lakehouse voor meer informatie.
Git-instellingen voor notebook
In het deelvenster Git-instellingen kunt u bepalen hoe notebooks samenwerken met broncodebeheer, inclusief opties voor Git-binding en het beheren van welke bestanden in de Source map zijn opgenomen in commits.
Notitie
Bewerk notebook-settings.json niet in de Git-opslagplaats om Git-koppelingen of middelen te beheren. Beheer deze instellingen via de pagina met notitieblokinstellingen.
Lakehouse Automatisch Koppelen in Git
Met Lakehouse Auto-Binding kan Fabric de juiste standaard lakehouse voor elke met Git verbonden werkruimte oplossen. Dit vermindert handmatige rebinding wanneer u notebooks verplaatst naar ontwikkel-, test- en productiewerkruimten.
Schakel deze functie in vanuit notebookinstellingen. Nadat u het hebt ingeschakeld, creëert Fabric notebook-settings.json in de opslagplaats en beheert dit bestand automatisch. Bewerk dit bestand niet handmatig.
Notitie
Git-integratie van notebooks ondersteunt het behouden van de bindingsrelatie tussen notebooks en hun gekoppelde lakehouses bij het synchroniseren tussen werkruimten. Wanneer u een notebook synchroniseert met een andere samenwerkingsomgeving, kunt u kiezen of deze is gekoppeld aan het lakehouse in de bronomgeving of het lakehouse in de nieuwe omgeving. Voor notebooks die al in Git zijn geversioneerd, wordt de fysieke ID van het gekoppelde lakehouse in de metagegevens van het notebook vervangen door een logische ID. Deze wijziging kan worden weergegeven in de Git-diff-weergave.
Mapondersteuning voor notebooks-resources in Git
Notitie
De map Omgevingsbronnen en integratie met implementatiepijplijnen en openbare API's worden momenteel niet ondersteund.
De ingebouwde map Resources kan worden toegevoegd aan Git, zodat scripts en configuratiebestanden versiebeheer ondergaan met de notebook.
Deze functie is standaard optioneel en uitgeschakeld. Schakel deze in vanuit notebookinstellingen in de sectie Git-instellingen. Nadat u deze hebt ingeschakeld, worden bestanden in de map Resources opgenomen in doorvoeringen. Omdat doorvoeringen een limiet van 50 MB hebben, gebruikt .gitignore u bestand- of Git-regels om grote of tijdelijke bestanden of mappen uit te sluiten.
Notitie
Alleen de .gitignore ingebouwde hoofdmap van de resource wordt van kracht.
Nadat u Git-regels hebt geconfigureerd en wijzigingen hebt doorgevoerd, slaat Fabric de regels op in de opslagplaats in fs-settings.json. Fabric genereert en beheert dit bestand om de configuratie van de opslagplaats consistent te houden. We raden u ook niet aan dit bestand rechtstreeks in de Git-opslagplaats te bewerken.
Notebook in implementatiepijplijnen
Gebruik implementatiepijplijnen om notebookwijzigingen te promoten in fasen zoals Ontwikkeling, Testen en Productie. Valideer updates in eerdere fasen voordat u ze naar productie promoveert.
Notebook-implementatie ondersteunt automatische binding voor de standaard lakehouse- en gekoppelde omgeving wanneer afhankelijke items zich in dezelfde werkruimte bevinden. Tijdens de implementatie kan Fabric deze afhankelijkheden opnieuw koppelen aan bijbehorende items in de doelwerkruimte. Wijzigingen in metagegevens kunnen worden weergegeven in de diff-weergave.
Als u een specifieke standaard lakehouse-doelfase nodig hebt, configureert u een implementatieregel om automatische binding te overschrijven.
De nieuwe gebruikersinterface voor de implementatiepijplijn wordt momenteel gebruikt in dit artikel. U kunt overschakelen naar de oude gebruikersinterface door de pijplijn Voor nieuwe implementatie uit te schakelen.
Notitie
Bekend probleem: de status van bevroren cellen in notebooks blijft niet behouden tijdens verzending.
Gebruik de volgende stappen om notebooks te implementeren via een implementatiepijplijn.
Maak een implementatiepijplijn of open een bestaande pijplijn. Zie Aan de slag met implementatiepijplijnen voor meer informatie.
Wijs werkruimten toe aan verschillende fasen op basis van uw implementatiedoelen.
Items selecteren, weergeven en vergelijken, inclusief notitieblokken, tussen fasen. De gemarkeerde badge toont het aantal gewijzigde items tussen de vorige fase en de huidige fase.
Selecteer Uitrollen om notebooks te promoten naar de ontwikkelings-, test- en productieomgevingen.
Controleer in het venster Implementeren in dit stadium de nieuwe en gewijzigde items. Als u de implementatie wilt voortzetten, zelfs als een of meer items mislukken, selecteert u Continue implementatie als een of meer items mislukken.
Nadat u de selectie hebt bekeken en bevestigd, selecteert u Implementeren.
(Optioneel.) Als u implementatieregels wilt maken, selecteert u Implementatieregels in het doelfase-item in de pijplijn (bijvoorbeeld Testen of Productie).
Zie Implementatieregels maken voor algemene regelgedrag en -beperkingen.
Configureer een standaard lakehouse-regel voor elke notebookimplementatie.
Met deze regel bepaalt u met welk lakehouse het notebook na de implementatie verbinding maakt in de beoogde fase.
Selecteer in het deelvenster Implementatieregels instellen de tegel Default Lakehouse .
Gebruik de vervolgkeuzelijsten Van en Naar om het standaard lakehouse van de bronfase toe te wijzen aan het standaard lakehouse van de doelfase.
- Hetzelfde als bij source lakehouse: behoud dezelfde standaardinstelling voor Lakehouse als de bronfase.
- N.v.t. (geen standaard lakehouse): Verwijder de standaardinstelling voor het lakehouse in de doelfase.
- Overig: Vervang het standaard lakehouse van de bronfase door een ander lakehouse in de doelfase.
Als u Overige selecteert in de vervolgkeuzelijst Aan, geeft u de details van het doellakehouse op:
- Lakehouse-id
- Lakehouse-naam
- Lakehouse-werkruimte-ID
Notitie
Lakehouse-id is vereist wanneer u deze regel configureert. U kunt de lakehouse-id ophalen uit de item-URL. Implementatieregels hebben voorrang op automatische binding. Als er een implementatieregel is geconfigureerd, krijgt deze voorrang boven het automatisch toegewezen lakehouse.
Bewaak de implementatiestatus vanuit de implementatiegeschiedenis.
