Bemærk
Adgang til denne side kræver godkendelse. Du kan prøve at logge på eller ændre mapper.
Adgang til denne side kræver godkendelse. Du kan prøve at ændre mapper.
En handling er en kørsel af et arbejdsområde-element, som en deployment udfører omkring udrulningen af et andet element. Handlinger er, hvordan en udrulningsplan udfører arbejde, som udrulning af objektmetadata alene ikke kan klare, såsom at udfylde en lakehouse-tabel før et lagervisning, der læser den, udrulles.
En handling tilhører en udrulningsgruppe, og en gruppe udruler præcis ét element. Gruppens handlinger drejer sig om den pågældende genstands udsendelse.
Vigtig
Denne funktion er i prøveversion.
Handlinger før og efter udrulning
Hver udrulningsgruppe har to sæt handlinger:
- Forud-udsendelseshandlinger kører, før gruppens genstand udsendes.
- Post-deploy-handlinger kører efter gruppens genstand er deployet.
En pre-deploy-handling kan ikke køre det samme item, som dens egen gruppe deployer, fordi det item endnu ikke er deployet, når handlingen kører.
Genstande-typer, du kan køre som en handling
Følgende itemtyper kan køre som deployment plan-handlinger:
| Varetype | Jobtype |
|---|---|
| Notebook | Execute |
| Datapipeline | Execute |
| Dataflow Gen2 | Execute |
| Kopier job | Execute |
| Funktion af brugerdata | Execute |
For definitionsstrukturen og jobegenskaberne, se Definition af udrulningsplan.
Hver handling kører genstanden. Genstanden definerer, hvad handlingen gør, og hvilke parametre den accepterer, ikke planen.
Ingen anden genstandstype kan køre som en handling. For varetyper, der overvejes, men ikke understøttes, se Overvejelser og begrænsninger.
Ordre handlinger inden for en udrulningsgruppe
Kædehandlinger for at kontrollere rækkefølgen, de kører i. Når du kæder én handling til en anden, kører udrulningen dem i den rækkefølge, så du kan bestille en handling, der indlæser data før den handling, der validerer den.
I det foregående billede løber Refresh_Sales kæden i søhusgruppen før Validate_Sales. Den følgende lagergruppe kører Notify , før den deployerer lageret.
Der gælder følgende regler:
- Du kan kæde en handling til andre handlinger i samme deploy-gruppe. I planfilen er en kæde en afhængighed af navnet på en anden handling.
- Handlingsnavne skal være unikke inden for deres udrulningsgruppe, fordi en kæde refererer til en handling ved navn.
- En kæde kan ikke sno sig selv tilbage. Systemet afviser en afhængighedscyklus, når du gemmer planen.
- Handlingerne kører én ad gangen. Handlinger, som du ikke kæder sammen, kører stadig ikke parallelt.
En udrulningsoperation stopper ved den første fejl, og systemet ruller ingen ændringer tilbage. For mere information, se Hvis en operation fejler.
Overfør parametre til en handling
En handling kan have parametre, som planen sender videre til det element, handlingen udfører. Hver parameter har et navn og en værdi, og parameternavne skal være unikke inden for en handling.
En parameterværdi er enten en literal værdi eller en reference til en variabel i et variabelbibliotek. En variabelreference gør det muligt for en enkelt plan at levere forskellige værdier pr. miljø i stedet for at hardkode en værdi, der kun er korrekt i ét arbejdsområde.
En variabelreference, der ikke kan løses til en kendt variabeltype, afvises, når planen gemmes.
Fordi planen sender værdierne videre til varen, skal du levere de parametre, som varen forventer. For hvilke parametre et element accepterer, se dokumentationen for den pågældende artikeltype.
Overvejelser og begrænsninger
Generelle begrænsninger i udrulningsplanen
- Du kan ikke bruge én plan til at deploye til mere end ét arbejdsområde i én gennemkørsel.
- Du kan kun knytte én udrulningsplan til en udrulningsoperation.
Begrænsninger ved at tilknytte en plan
- En planvedhæftning gælder kun for den nuværende drift. Du kan ikke konfigurere en plan som standard for fremtidige udrulninger eller planlægge selve planen. Hvis et implementeringsværktøj planlægger en operation, skal operationen vedhæfte planen hver gang den kører.
- Du kan ikke knytte en plan til en enkelt-item importoperation.
- Biblioteket
fabric-cicdunderstøtter ikke udrulningsplaner.
Begrænsninger under en udrulning
- Du kan ikke udrulle uafhængige deployment-grupper parallelt.
- En mislykket udsendelse rulles ikke tilbage. Genstande, der allerede er deployeret, bliver i målarbejdsområdet, og senere items bliver ikke deployeret.
Begrænsninger for planhandlinger
- Kun understøttede kombinationer af genstande og jobtyper kan køre som handlinger før eller efter udrulning. Se Item-typer, du kan køre som en handling.
- Du kan ikke bruge det samme Dataflow Gen2-element i mere end én handling i en plan. Dens opdateringsjob kan ikke køre mere end én gang ad gangen, så canvas advarer dig, når du tilføjer den anden forekomst, og den anden forekomst blokeres under udrulningen.
- Du kan ikke returnere mere end 512 KB fra en brugerdatafunktionshandling. Større output er afkortet. Handlingen lykkes alligevel.
- Du kan ikke lave en handling ved at vente på, at de tjenester, den leverer, indhenter dig. En handling fuldføres, når selve handlingen slutter, så den næste handling kan starte, før de producerede data kan forespørges.
- Du kan ikke bruge en deploymentplan til at ændre det aktive værdisæt i et variabelbibliotek under deployment. Variabelreferencer afløses i forhold til det værdisæt, der allerede er aktivt i målarbejdsområdet. I et nyoprettet målarbejdsområde er Standard aktiv, indtil du vælger og gemmer et andet værdisæt. For mere information, se Variabelbibliotek CI/CD.
Begrænsninger ved planudarbejdelse
- Du kan ikke tilføje mere end ét element til en udrulningsgruppe.
- Lærredet understøtter kun automatisk layout.
Grænser for størrelsen på udrulningsplanen
En plan, der overskrider nogen af disse grænser, afvises, når den er gemt. Begrænsningerne håndhæves, hver gang en plan gemmes, så de gælder for både lærredet, REST API'en, et pull fra Git og eksterne værktøjer.
| Element | Grænse |
|---|---|
| Planstørrelse | 1 MB |
| Længde af et gruppe- eller trinnavn | 60 tegn |
| Grupper i en plan | 1,000 |
| Afhængigheder af en gruppe | 1,000 |
| Forud-deploy handlinger i en gruppe | 20 |
| Handlinger efter udrulning i en gruppe | 20 |
| Afhængigheder af en handling | 20 |
| Parametre på en handling | 20 |