Wat is een implementatieplan in Microsoft Fabric? (voorvertoning)

Een Microsoft Fabric-implementatieplan is een werkruimte-item dat expliciete itemvolgorde en geautomatiseerde acties toevoegt aan een implementatieoperatie. Gebruik een plan om items in een specifieke volgorde in te zetten. Je kunt het ook gebruiken om een notebook, datapipeline of een ander ondersteund item te draaien vóór of na de uitrol van een item.

Een implementatieplan werkt met deze implementatietools:

• Git-integratie
• Implementatiepijplijnen
• Ondersteunde REST-API's

In dit artikel verwijst deployment tool naar een van deze ondersteunde tools. Je voert geen plan uit op zichzelf. Je voegt het toe wanneer je een operatie start met een deploymenttool.

Wanneer een implementatieplan te gebruiken

Gebruik een inzetplan wanneer:

Je hebt geen implementatieplan nodig als de standaardvolgorde van de deployment tool voldoende is en er geen acties nodig zijn.

Componenten van het implementatieplan

Een implementatieplan bevat de volgende componenten:

Voor ondersteunde actietypes en actiegedrag, zie acties van het implementatieplan.

Hoe een implementatieplan werkt

Elke inzetoperatie combineert drie invoer:

• Geselecteerde items: De items die voor de operatie zijn geselecteerd.
• Inzetplan: De expliciete volgorde en acties die aan die items horen.
• Fabric lineage: De afhankelijkheden die Fabric detecteert tussen items.

Bepaal de reikwijdte van de uitrol

De inzettool bepaalt de bron, het doel en de items in de operatie. Een plan toevoegen vervangt die selectie niet. Geselecteerde items die niet in een deployment-groep zitten, worden nog steeds uitgezet door gebruik te maken van het standaardgedrag van de tool.

Het toevoegen van een abonnement selecteert niet automatisch de items waarnaar het verwijst. Selecteer op een selectief uitroloppervlak de items die je wilt uitrollen en zorg ervoor dat de items die door de acties van het plan nodig zijn beschikbaar zijn in de doelwerkruimte wanneer die acties worden uitgevoerd.

Een implementatieplan regelt de inzet en acties van items. Het implementeert geen werkruimte-niveau configuratie zoals werkruimte-identiteiten, verbindingen, gateway-bindings of Spark-instellingen. Het configureren van de doelwerkruimte vóór een actie hangt af van die instellingen.

Los de inzetvolgorde op

Fabric combineert expliciete afhankelijkheden tussen implementatiegroepen met afhankelijkheden die zijn gedetecteerd op basis van gegevensafstamming. Een plan kan een volgorde toevoegen die de lijn niet vertegenwoordigt, maar het verwijdert geen afhankelijkheden die Fabric detecteert.

Voor een gedetailleerd scenario dat laat zien hoe de geselecteerde items, planafhankelijkheden, afkomst en runtime-acties samenwerken, zie voorbeelden van implementatieplannen.

Voer implementatiegroepen en acties uit

Voor elke deployment-groep voert Fabric zijn pre-deploy acties uit, deployt het item van de groep en voert vervolgens de post-deploy acties uit. Afhankelijkheden tussen groepen en acties bepalen hun volgorde. De positie van een item in het planbestand bepaalt niet de volgorde.

Het toevoegen van een plan is optioneel. Zonder plan gebruikt het geselecteerde implementatietool zijn standaardgedrag.

Voeg een inzetplan toe

Je kunt een plan toevoegen wanneer je een ondersteunde Git-integratieoperatie gebruikt, content via een deployment pipeline deployt, of een ondersteunde REST API aanroept. De bijlage geldt alleen voor die operatie. Voor de ondersteunde oppervlakken en het planselectiegedrag, zie Een implementatieplan bijvoegen.

Maak en versioneer een implementatieplan

Maak een plan op het deployment plan-canvas, waarin je deploymentgroepen toevoegt, hun volgorde definieert en acties configureert. Voor instructies, zie Maak een inzetplan.

Een inzetplan is een werkruimte-item. Wanneer de werkruimte verbonden is met Git, commit dan het plan met de items waarnaar het verwijst zodat het plan door je CI/CD-proces kan gaan.

Als een bewerking faalt

De bewerking stopt wanneer een item of actie faalt en wordt voltooid werk niet teruggerold. Voor storingsgedrag en oplossingstappen, zie Troubleshoot deployment plans.

Overwegingen en beperkingen

Beperkingen van het algemene inzetplan

• Je kunt niet één plan gebruiken om in één enkele run in meer dan één werkruimte te deployen.
• Je kunt slechts één implementatieplan aan een implementatieoperatie koppelen.

Beperkingen voor het aanvullen van een plan

• Een planbijlage geldt alleen voor de huidige operatie. Je kunt een plan niet instellen als standaard voor toekomstige implementaties of het plan zelf plannen. Als een deploymenttool een bewerking plant, moet de bewerking het plan telkens wanneer deze wordt uitgevoerd koppelen.
• Je kunt geen plan koppelen aan een importoperatie met één item.
• De fabric-cicd bibliotheek ondersteunt geen implementatieplannen.

Beperkingen tijdens een inzet

• Je kunt geen onafhankelijke deploymentgroepen parallel uitrollen.
• Een mislukte uitzending wordt niet teruggedraaid. Items die al zijn geïmplementeerd, blijven in de doelwerkruimte en volgende items worden niet geïmplementeerd.

Beperkingen voor planacties

• Alleen ondersteunde item- en taaktypecombinaties kunnen worden uitgevoerd als pre-deploy of post-deploy acties. Bekijk Itemtypes die je als actie kunt uitvoeren.
• Je kunt hetzelfde Dataflow Gen2-item niet in meer dan één actie in een plan gebruiken. De vernieuwingstaak kan niet meer dan één keer tegelijk worden uitgevoerd, dus het canvas waarschuwt je wanneer je het tweede exemplaar toevoegt, en dat tweede exemplaar wordt tijdens de implementatie geblokkeerd.
• Je kunt niet meer dan 512 KB teruggeven vanuit een user data functie-actie. Grotere output wordt afgekapt. De actie slaagt nog steeds.
• Je kunt een actie niet laten wachten tot de services die erdoor worden gevoed zijn bijgewerkt. Een actie wordt voltooid wanneer de actie zelf eindigt, zodat de volgende actie kan beginnen voordat de geproduceerde data opvraagbaar is.
• Je kunt geen deploymentplan gebruiken om de actieve waardeset van een variabelenbibliotheek tijdens de deployment te wijzigen. Variabelverwijzingen worden opgelost op basis van de waardenset die al actief is in de doelwerkruimte. In een nieuw aangemaakt doelwerkruimte is Default actief totdat je een andere waardeset selecteert en opslaat. Voor meer informatie, zie variabelenbibliotheek CI/CD.

Beperkingen voor het opstellen van plannen

• Je kunt niet meer dan één item toevoegen aan een deployment-groep.
• Het canvas ondersteunt alleen automatische lay-out.

Limieten voor de grootte van het implementatieplan

Een plan dat een van deze limieten overschrijdt, wordt afgewezen wanneer het wordt opgeslagen. De limieten worden gehandhaafd wanneer een plan wordt opgeslagen, dus ze gelden voor het canvas, de REST API, een pull van Git en externe tools.

Verwante onderwerpen

• Maak een implementatieplan
• Voorbeelden van implementatieplannen
• Introductie tot CI/CD in Microsoft Fabric
• Inleiding tot Git-integratie
• Inleiding tot implementatiepijplijnen
• Kies een Fabric CI/CD-workflow
• Begrijp afhankelijkheidsbinding bij cross-workspace implementatie