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.
Een actie is een uitvoering van een werkruimteonderdeel die door een deployment wordt uitgevoerd tijdens de uitrol van een ander item. Acties zijn de manier waarop een deploymentplan werk kan uitvoeren dat alleen het implementeren van itemmetadata niet kan doen, zoals het vullen van een lakehouse-tabel voordat een warehouseweergave die deze tabel leest wordt geïmplementeerd.
Een actie behoort tot een deployment-groep, en een groep deployt precies één item. De acties van de groep draaien om de inzet van dat item.
Important
Deze functie is beschikbaar als preview-versie.
Acties vóór en na de uitzending
Elke deployment-groep voert twee sets acties uit:
- Pre-deploy-acties worden uitgevoerd voordat het item van de groep wordt uitgezet.
- Post-deploy acties worden uitgevoerd nadat het item van de groep is gedeployeerd.
Een pre-deploy-actie kan niet hetzelfde item uitvoeren dat door de eigen groep wordt geïmplementeerd, omdat dat item nog niet is geïmplementeerd als de actie wordt uitgevoerd.
Itemtypes die je als actie kunt uitvoeren
De volgende itemtypen kunnen worden uitgevoerd als acties van het deployment plan:
| Onderdelentype | Functietype |
|---|---|
| Notitieboek | Execute |
| Gegevenspijplijn | Execute |
| Gegevensstroom Gen2 | Execute |
| Taak kopiëren | Execute |
| Functie Gebruikersgegevens | Execute |
Voor de definitiestructuur en taakeigenschappen, zie definitie van het implementatieplan.
Elke actie voert het item uit. Het item bepaalt wat de actie doet en welke parameters het accepteert, niet het plan.
Geen enkel ander itemtype kan als actie worden uitgevoerd. Voor itemtypes die worden overwogen maar niet worden ondersteund, zie Overwegingen en beperkingen.
Acties binnen een deploymentgroep ordenen
Kettingacties om de volgorde waarin ze lopen te bepalen. Wanneer je de ene actie aan de andere koppelt, voert de deployment ze in die volgorde uit, zodat je een actie kunt bestellen die data laadt vóór de actie die het valideert.
In de voorgaande afbeelding loopt de keten in de lakehouse-groep van Refresh_Sales vóór Validate_Sales. De volgende warehousegroep voert Notify uit voordat de warehouse wordt geïmplementeerd.
De volgende regels zijn van toepassing:
- Je kunt een actie koppelen aan andere acties in dezelfde deployment-groep. In het planbestand is een keten een afhankelijkheid van de naam van een andere actie.
- Actienamen moeten uniek zijn binnen hun deployment-groep, omdat een keten een actie bij naam aanduidt.
- Een ketting kan niet terug op zichzelf draaien. Het systeem weigert een afhankelijkheidscyclus wanneer je het plan opslaat.
- Acties worden één voor één uitgevoerd. Acties die je niet aan elkaar koppelt, lopen nog steeds niet parallel.
Een deployment-operatie stopt bij de eerste fout, en het systeem rolt geen wijzigingen terug. Voor meer informatie, zie Als een bewerking mislukt.
Geef parameters door aan een actie
Een actie kan parameters bevatten, die het plan doorgeeft aan het item dat de actie uitvoert. Elke parameter heeft een naam en een waarde, en parameternamen moeten uniek zijn binnen een actie.
Een parameterwaarde is ofwel een letterlijke waarde of een verwijzing naar een variabele in een variabelebibliotheek. Een verwijzing naar een variabele maakt het mogelijk dat één plan per omgeving verschillende waarden gebruikt, in plaats van een waarde hard te coderen die maar in één werkruimte klopt.
Een variabelenreferentie die niet wordt opgelost naar een bekend variabeletype wordt afgewezen wanneer het plan wordt opgeslagen.
Omdat het plan de waarden doorgeeft aan het item, geef je de parameters die het item verwacht. Voor welke parameters een item accepteert, zie de documentatie van dat itemtype.
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-cicdbibliotheek 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.
- Wanneer een implementatieplan een actieve waardeset specificeert voor een Variable Library, wordt die waardeset toegepast in de doelwerkruimte wanneer je het plan gebruikt. Je kunt deze selectie niet overrulen tijdens de uitrol. Om een andere waardeset te gebruiken, bewerk je het deploymentplan.
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.
| Element | Limit |
|---|---|
| Grootte van het plan | 1 MB |
| Lengte van een groeps- of stapnaam | 60 tekens |
| Groepen in een plan | 1,000 |
| Afhankelijkheden van een groep | 1,000 |
| Acties vóór implementatie in een groep | 20 |
| Acties na implementatie in een groep | 20 |
| Afhankelijkheden van een handeling | 20 |
| Parameters voor een actie | 20 |