Hvad er en implementeringsplan i Microsoft Fabric? (forhåndsversion)

En Microsoft Fabric-implementeringsplan er et arbejdsområde, der tilføjer eksplicit varerækkefølge og automatiserede handlinger til en udrulningsoperation. Brug en plan til at udrulle genstande i en bestemt rækkefølge. Du kan også bruge det til at køre en notesbog, datapipeline eller et andet understøttet element før eller efter et element deployeres.

En udrulningsplan arbejder med disse udrulningsværktøjer:

  • Git-integration
  • Udrulningspipelines
  • Understøttede REST API'er

I denne artikel refererer implementeringsværktøj til et af disse understøttede værktøjer. Du kører ikke en plan alene. Du vedhæfter det, når du starter en operation med et deployeringsværktøj.

Vigtig

Denne funktion er i prøveversion.

Hvornår skal man bruge en udrulningsplan

Brug en udrulningsplan, når:

Scenarie Hvordan en plan hjælper
Genstande skal deployeres i en rækkefølge, som Fabric-linjen ikke repræsenterer. Planen definerer eksplicitte afhængigheder mellem deployment-grupper.
Arbejdet skal køre før eller efter en genstand bliver udsendt. Planen kører understøttede elementer som pre-deploy eller post-deploy handlinger.
Operationen kræver både eksplicit rækkefølge og Fabric-items-afhængigheder. Fabric kombinerer planen med afstamning, når den bestemmer varerækkefølgen.

Du behøver ikke en udrulningsplan, når udrulningsværktøjets standardordre er tilstrækkelig, og ingen handlinger er nødvendige.

Komponenter i udrulningsplanen

En udrulningsplan indeholder følgende komponenter:

Komponent Formål
Udrulningsgruppe Et element at udrulle og dets handlinger før eller efter udrulning.
Trin Udruler genstanden i en udrulningsgruppe.
Aktion En gennemspilning af et understøttet item før eller efter gruppens item deployeres.

For understøttede handlingstyper og handlingsadfærd, se Implementeringsplanhandlinger.

Sådan fungerer en implementeringsplan

Hver udrulningsoperation kombinerer tre input:

  • Udvalgte elementer: De elementer, der er udvalgt til operationen.
  • Udrulningsplan: Den eksplicitte rækkefølge og handlinger forbundet med disse elementer.
  • Fabric lineage: De afhængigheder, Fabric registrerer mellem varer.

Diagram, der viser udvalgte varer, en udrulningsplan og Fabric-linje, der kombineres for at bestemme varerækkefølge og handlinger for et målarbejdsområde.

Bestem udrulningsomfanget

Udrulningsværktøjet bestemmer kilden, målet og genstandene i operationen. At vedhæfte en plan erstatter ikke det valg. Udvalgte elementer, der ikke er i en deployment-gruppe, deployes stadig ved hjælp af værktøjets standardadfærd.

Vedhæftning af en plan vælger ikke automatisk de punkter, den refererer til. På en selektiv udrulningsoverflade skal du vælge de elementer, du vil udrulle, og sikre dig, at de elementer, der kræves af planens handlinger, er tilgængelige i målarbejdsområdet, når disse handlinger kører.

En udrulningsplan styrer udrulning og handlinger for genstande. Den udruler ikke konfiguration på arbejdsområdeniveau såsom arbejdsområdeidentiteter, forbindelser, gateway-bindinger eller Spark-indstillinger. Konfigurer målarbejdsområdet før en handling afhænger af disse indstillinger.

Løs deployment-rækkefølgen

Fabric kombinerer eksplicitte afhængigheder mellem deployment-grupper med afhængigheder, der opdages fra lineage. En plan kan tilføje en rækkefølge, som lineage ikke repræsenterer, men den fjerner ikke afhængigheder, som Fabric opdager.

For et detaljeret scenarie, der viser, hvordan de udvalgte elementer, planafhængigheder, linje og runtime-handlinger arbejder sammen, se eksempler på udrulningsplan.

Udfør udrulningsgrupper og handlinger

For hver deploy-gruppe kører Fabric sine pre-deploy-handlinger, deployer gruppens element og udfører derefter sine post-deploy-handlinger. Afhængigheder mellem grupper og handlinger bestemmer deres rækkefølge. En genstands placering i planfilen definerer ikke dens rækkefølge.

At vedhæfte en plan er valgfrit. Uden en plan bruger det valgte udrulningsværktøj dets standardadfærd.

Vedhæft en udrulningsplan

Du kan vedhæfte en plan, når du bruger en understøttet Git-integrationsoperation, deployer indhold gennem en deployment-pipeline eller kalder en understøttet REST API. Vedhæftningen gælder kun for den pågældende operation. For de understøttede overflader og planvalgsadfærd, se Vedhæft en udrulningsplan.

Opret og udarbejde en udrulningsplan

Opret en plan på udrulningsplan-canvaset, hvor du tilføjer udrulningsgrupper, definerer deres rækkefølge og konfigurerer handlinger. For instruktioner, se Opret en udrulningsplan.

En udrulningsplan er et arbejdsområde. Når arbejdsområdet er forbundet til Git, commit planen med de elementer, den refererer til, så planen kan bevæge sig gennem din CI/CD-proces.

Hvis en operation fejler

Operationen stopper, når et element eller en handling fejler, og ruller ikke færdigt arbejde tilbage. For fejladfærd og løsningstrin, se Fejlfinding af udrulningsplaner.

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-cicd understø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

Relateret indhold

  • Last updated on