Vad är en distributionsplan i Microsoft Fabric? (förhandsversion)

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.

Diagram som visar valda objekt, en distributionsplan och Fabric-härkomst som tillsammans avgör objektordning och åtgärder för en målarbetsyta.

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-cicd stö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