Hva er en distribusjonsplan i Microsoft Fabric? (forhåndsversjon)

En Microsoft Fabric-distribusjonsplan er et arbeidsområdeelement som legger til eksplisitt varerekkefølge og automatiserte handlinger til en distribusjonsoperasjon. Bruk en plan for å plassere gjenstander i en bestemt rekkefølge. Du kan også bruke den til å kjøre en notatbok, datapipeline eller et annet støttet element før eller etter at et element distribueres.

En utrullingsplan fungerer med disse utrullingsverktøyene:

• Git-integrering
• Utrullingskanaler
• Støttede REST-API-er

I denne artikkelen refererer distribusjonsverktøyet til et av disse støttede verktøyene. Du kjører ikke en plan alene. Du fester det når du starter en operasjon med et deployeringsverktøy.

Når man skal bruke en utrullingsplan

Bruk en utplasseringsplan når:

Du trenger ikke en deployeringsplan når deployeringsverktøyets standardordre er tilstrekkelig og ingen handlinger kreves.

Komponenter i utrullingsplanen

En utrullingsplan inneholder følgende komponenter:

For støttede handlingstyper og handlingsatferd, se Deployeringsplan-handlinger.

Hvordan en utplasseringsplan fungerer

Hver utrullingsoperasjon kombinerer tre innganger:

• Utvalgte elementer: Elementene valgt for operasjonen.
• Utplasseringsplan: Den eksplisitte rekkefølgen og handlingene knyttet til disse elementene.
• Fabric lineage: Avhengighetene Fabric oppdager mellom gjenstander.

Bestem omfanget av utplasseringen

Utplasseringsverktøyet bestemmer kilden, målet og elementene i operasjonen. Å legge ved en plan erstatter ikke dette valget. Utvalgte elementer som ikke er i en distribusjonsgruppe, distribueres fortsatt ved å bruke verktøyets standardoppførsel.

Å legge ved en plan velger ikke automatisk de elementene den refererer til. På en selektiv deployeringsflate, velg de elementene du vil deployere, og sørg for at elementene som kreves av planens handlinger er tilgjengelige i målarbeidsområdet når disse handlingene kjøres.

En utrullingsplan styrer utplassering og handlinger for gjenstander. Den distribuerer ikke konfigurasjon på arbeidsområdenivå som arbeidsområdeidentiteter, tilkoblinger, gateway-bindinger eller Spark-innstillinger. Konfigurer målarbeidsområdet før en handling avhenger av disse innstillingene.

Løs utplasseringsrekkefølgen

Fabric kombinerer eksplisitte avhengigheter mellom distribusjonsgrupper med avhengigheter oppdaget fra slektskap. En plan kan legge til en rekkefølge som Lineage ikke representerer, men den fjerner ikke avhengigheter som Fabric oppdager.

For et detaljert scenario som viser hvordan de valgte elementene, planavhengigheter, linje og kjøretidshandlinger fungerer sammen, se eksempler på distribusjonsplan.

Utfør distribusjonsgrupper og handlinger

For hver deployeringsgruppe kjører Fabric sine pre-deploy-handlinger, deployerer gruppens gjenstand, og kjører deretter sine post-deploy-handlinger. Avhengigheter mellom grupper og handlinger bestemmer rekkefølgen deres. En gjenstands posisjon i planfilen definerer ikke rekkefølgen.

Å legge ved en plan er valgfritt. Uten en plan bruker det valgte distribusjonsverktøyet sin standardoppførsel.

Legg ved en utplasseringsplan

Du kan legge ved en plan når du bruker en støttet Git-integrasjonsoperasjon, distribuerer innhold gjennom en distribusjonspipeline, eller kaller et støttet REST API. Vedlegget gjelder kun for den operasjonen. For støttede flater og planvalg, se Vedlegg en utrullingsplan.

Lag og utgi en distribusjonsplan

Lag en plan på utrullingsplan-lerretet, hvor du legger til distribusjonsgrupper, definerer rekkefølgen deres og konfigurerer handlinger. For instruksjoner, se Lag en utplasseringsplan.

En deployeringsplan er et arbeidsområde. Når arbeidsområdet er koblet til Git, commit planen med elementene den refererer til, slik at planen kan gå gjennom din CI/CD-prosess.

Hvis en operasjon feiler

Operasjonen stopper når et element eller en handling feiler og ruller ikke tilbake fullført arbeid. For feilatferd og løsningssteg, se Feilsøk deployeringsplaner.

Hensyn og begrensninger

Generelle begrensninger i utplasseringsplanen

• Du kan ikke bruke én plan til å deploye til mer enn ett arbeidsområde i én og samme kjøring.
• Du kan bare knytte én distribusjonsplan til en distribusjonsoperasjon.

Begrensninger ved å legge ved en plan

• Et planvedlegg gjelder kun for den nåværende driften. Du kan ikke konfigurere en plan som standard for fremtidige utrullinger eller planlegge selve planen. Hvis et distribusjonsverktøy planlegger en operasjon, må operasjonen legge ved planen hver gang den kjøres.
• Du kan ikke knytte en plan til en enkelt importoperasjon.
• Biblioteket fabric-cicd støtter ikke utrullingsplaner.

Begrensninger under en utplassering

• Du kan ikke sette opp uavhengige distribusjonsgrupper parallelt.
• En mislykket deployering rulles ikke tilbake. Gjenstander som allerede er distribuert forblir i målarbeidsområdet, og senere gjenstander deployeres ikke.

Begrensninger for planhandlinger

• Kun støttede kombinasjoner av gjenstander og jobbtyper kan kjøres som handlinger før eller etter utrulling. Se Gjenstandstyper du kan kjøre som en handling.
• Du kan ikke bruke samme Dataflow Gen2-element i mer enn én handling i en plan. Oppdateringsjobben kan ikke kjøres mer enn én gang om gangen, så lerretet advarer deg når du legger til den andre forekomsten, og den andre forekomsten blokkeres under distribusjonen.
• Du kan ikke returnere mer enn 512 KB fra en user data function action. Større produksjon er avkortet. Handlingen lykkes likevel.
• Du kan ikke gjøre en handling og vente på at tjenestene den leverer skal ta igjen. En handling fullføres når selve handlingen avsluttes, slik at neste handling kan starte før dataene den produserte er spørrbare.
• Når en distribusjonsplan spesifiserer et aktivt verdisett for et variabelbibliotek, brukes dette verdisettet i målarbeidsområdet når du bruker planen. Du kan ikke overstyre dette valget under utplassering. For å bruke et annet verdisett, rediger distribusjonsplanen.

Begrensninger for planutarbeidelse

• Du kan ikke legge til mer enn ett element i en deployeringsgruppe.
• Lerretet støtter kun automatisk layout.

Grenser for utrullingsplanens størrelse

En plan som overskrider noen av disse grensene blir avvist når den er lagret. Begrensningene håndheves hver gang en plan lagres, så de gjelder både lerretet, REST API, en henting fra Git og eksterne verktøy.

Relatert innhold

• Lag en utrullingsplan
• Eksempler på utrullingsplaner
• Introduksjon til CI/CD i Microsoft Fabric
• Innføring i Git-integrering
• Innføring i utrullingspipelines
• Velg en Fabric CI/CD-arbeidsflyt
• Forstå avhengighetsbinding i tverrarbeidsområde-distribusjon