Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
En Microsoft Fabric-distributionsplan är ett arbetsytsobjekt som lägger till explicit artikelordning och automatiserade åtgärder till en distributionsoperation. Använd en plan för att placera ut föremål i en specifik ordning. Du kan också använda den för att köra en anteckningsbok, datapipeline eller ett annat stödd objekt före eller efter att ett objekt distribueras.
En distributionsplan fungerar med dessa distributionsverktyg:
- Git-integrering
- Utrullningspipelines
- Stödda REST-API:er
I denna artikel syftar distributionsverktyget på något av dessa stödda verktyg. Du kör inte en plan separat. Du bifogar den när du startar en operation med ett distributionsverktyg.
Important
Den här funktionen är i förhandsversion.
När man ska använda en distributionsplan
Använd en distributionsplan när:
| Scenario | Hur en plan hjälper |
|---|---|
| Föremål måste distribueras i en ordning som Fabric-linjen inte representerar. | Planen definierar explicita beroenden mellan distributionsgrupper. |
| Arbetet måste pågå före eller efter att ett föremål placeras ut. | Planen kör stödda objekt som för- eller efterimplementeringsåtgärder. |
| Operationen kräver både explicit ordning och Fabric-objektberoenden. | Fabric kombinerar planen med släktlinje när den bestämmer föremålsordningen. |
Du behöver ingen distributionsplan när distributionsverktygets standardordning är tillräcklig och inga åtgärder krävs.
Komponenter i utrullningsplanen
En distributionsplan innehåller följande komponenter:
| Komponent | Purpose |
|---|---|
| Utplaceringsgrupp | Ett objekt att driftsätta och dess åtgärder före eller efter driftsättning. |
| Steg | Distribuerar föremålet i en distributionsgrupp. |
| Action | Driftsättning av ett objekt som stöds sker före eller efter gruppens objekt. |
För stödda handlingstyper och handlingsbeteende, se Insatsplanåtgärder.
Hur en distributionsplan fungerar
Varje utrullningsoperation kombinerar tre indata:
- Utvalda föremål: De föremål som valts för operationen.
- Distributionsplan: Den uttryckliga ordningen och åtgärderna som hör till dessa objekt.
- Fabric-linje: De beroenden som Fabric upptäcker mellan föremål.
Bestäm omfattningen av utplaceringen
Distributionsverktyget bestämmer källa, mål och föremål i operationen. Att bifoga en plan ersätter inte det valet. Utvalda objekt som inte finns i en distributionsgrupp distribueras fortfarande genom att använda verktygets standardbeteende.
Att bifoga en plan väljer inte automatiskt de objekt som refereras till. På en selektiv utplaceringsyta, välj de objekt du vill distribuera och se till att de objekt som krävs av planens åtgärder finns tillgängliga i målarbetsytan när dessa åtgärder körs.
En distributionsplan styr utplacering och åtgärder för föremål. Den distribuerar inte konfiguration på arbetsytsnivå såsom arbetsytidentiteter, anslutningar, gateway-bindningar eller Spark-inställningar. Att konfigurera målarbetsytan innan en åtgärd beror på dessa inställningar.
Lös utplaceringsordningen
Fabric kombinerar explicita beroenden mellan distributionsgrupper med beroenden som upptäckts från härstamning. En plan kan lägga till en ordning som Lineage inte representerar, men den tar inte bort beroenden som Fabric upptäcker.
För ett detaljerat scenario som visar hur de valda elementen, planberoenden, härstamning och körningsåtgärder samarbetar, se exempel på distributionsplaner.
Utför distribueringsgrupper och åtgärder
För varje deploygrupp kör Fabric sina pre-deploy-åtgärder, deployar gruppens objekt och kör sedan sina post-deploy-åtgärder. Beroenden mellan grupper och handlingar avgör deras ordning. En föremåls position i planfilen definierar inte dess ordning.
Att bifoga en plan är frivilligt. Utan en plan använder det valda distributionsverktyget dess standardbeteende.
Bifoga en distributionsplan
Du kan bifoga en plan när du använder en stödd Git-integrationsoperation, distribuerar innehåll via en distributionspipeline eller anropar ett stödd REST API. Tillägget gäller endast den operationen. För stödda ytor och planvalsbeteende, se Bifoga en utrullningsplan.
Skapa och version av en distributionsplan
Skapa en plan på distributionsplanscanvasen, där du lägger till distributionsgrupper, definierar deras ordning och konfigurerar åtgärder. För instruktioner, se Skapa en distributionsplan.
En distributionsplan är ett arbetsyteobjekt. När arbetsytan är ansluten till Git ska du checka in planen tillsammans med de objekt som planen refererar till, så att planen kan gå igenom din CI/CD-process.
Om en operation misslyckas
Operationen stoppas när ett föremål eller en åtgärd misslyckas och rullar inte tillbaka slutfört arbete. Information om felbeteende och steg för att lösa problem finns i Felsöka distributionsplaner.
Överväganden och begränsningar
Begränsningar i allmänna utbyggnadsplaner
- Du kan inte använda en plan för att distribuera till mer än en arbetsplats under en och samma körning.
- Du kan bara koppla en distributionsplan till en utrullningsoperation.
Begränsningar för att bifoga en plan
- En planbilaga gäller endast för den aktuella driften. Du kan inte konfigurera en plan som standard för framtida utplaceringar eller schemalägga planen själv. Om ett distributionsverktyg schemalägger en operation måste operationen bifoga planen varje gång den körs.
- Du kan inte koppla en plan till en importoperation med en enda artikel.
- Biblioteket
fabric-cicdstöder inte distributionsplaner.
Begränsningar under en utplacering
- Du kan inte distribuera oberoende distributionsgrupper parallellt.
- En misslyckad utplacering rullas inte tillbaka. Föremål som redan är utplacerade stannar i målarbetsytan, och senare objekt distribueras inte.
Begränsningar för planåtgärder
- Endast stödda kombinationer av föremåls- och jobbtyper kan köras som för- eller efter-utplaceringsåtgärder. Se objekttyper du kan köra som en åtgärd.
- Du kan inte använda samma Dataflow Gen2-objekt i mer än en handling i en plan. Dess uppdateringsjobb kan inte köras mer än en gång åt gången, så canvasen varnar dig när du lägger till den andra förekomsten, och den andra förekomsten blockeras under distributionen.
- Du kan inte returnera mer än 512 KB från en användardatafunktion. Större produktion är förkortad. Actionen lyckas ändå.
- Du kan inte låta en handling vänta på att de tjänster den levererar ska hinna ikapp. En åtgärd slutförs när själva handlingen avslutas, så nästa åtgärd kan starta innan den data den producerat kan ifrågasättas.
- När en distributionsplan specificerar en aktiv värdeuppsättning för ett variabelbibliotek tillämpas den värdeuppsättningen i målarbetsytan när du använder planen. Du kan inte åsidosätta detta val under distribution. För att använda en annan värdeuppsättning, redigera distributionsplanen.
Begränsningar för planskapande
- Du kan inte lägga till mer än ett föremål i en distributionsgrupp.
- Canvasen stöder endast automatisk layout.
Begränsningar för utrullningsplanens storlek
En plan som överskrider någon av dessa gränser avvisas när den sparas. Begränsningarna tillämpas varje gång en plan sparas, så de gäller både canvas, REST API, en pull från Git och externa verktyg.
| Element | Limit |
|---|---|
| Planstorlek | 1 MB |
| Längd på ett grupp- eller stegnamn | 60 tecken |
| Grupper i planen | 1,000 |
| Beroenden av en grupp | 1,000 |
| Åtgärder före distribution i en grupp | 20 |
| Efterutplaceringsåtgärder i en grupp | 20 |
| Beroenden av en handling | 20 |
| Parametrar på en handling | 20 |