Del via

Arbeidsbelastningsmanifest

Oversikt

WorkloadManifest.xml Og Item.xml filene kreves for arbeidsbelastningsdefinisjon i Fabric. De har de grunnleggende konfigurasjonsinnstillingene for arbeidsbelastning og arbeidsbelastningselementer for konfigurasjon, og de fungerer som en veiledning for konfigurasjon og administrasjon av arbeidsbelastninger, som bidrar til å definere, dele og registrere viktige arbeidsbelastningsdetaljer for jevn integrering i Fabric.

I eksempelrepositoriet genereres en .nupkg fil fra XML-filene i src/Packages/manifest mappen under byggeprosessen. Denne pakkede filen inneholder all nødvendig informasjon om arbeidsbelastningen. workload-dev-mode.json I filen finnes det et felt ManifestPackageFilePath kalt som skal peke til den nylig opprettede .nupkg filen.

Opplastings- og registreringsprosess

  1. Brukergodkjenning: Under utvikling starter godkjenningen opplastings- og registreringsprosessen når du kjører eksemplet. Dette sikrer riktig tilknytning til arbeidsbelastningen med identiteten din.
  2. Manifestanalyse: Det opplastede manifestet gjennomgår analyse for å validere strukturen og innholdet. Dette trinnet sikrer at manifestet er riktig formatert og klar for videre behandling.
  3. Arbeidsbelastningsregistrering: Hvis analyse er vellykket, registreres arbeidsbelastningen i Fabric. Viktige konfigurasjonsdetaljer, for eksempel arbeidsbelastnings-ID-en, lagres i Fabric-databasen, noe som muliggjør effektiv arbeidsbelastningsbehandling.

Arbeidsbelastningsmanifest – viktige manifestkomponenter

Manifestet, hvis struktur er definert av WorkloadDefinition.xsd, skisserer kjerneattributter for en arbeidsbelastning, for eksempel navn, program og endepunkter.

SchemaVersion-attributt

Representerer fabric's WorkloadDefinition.xsd publisert versjon.

WorkloadName-attributt

Arbeidsbelastningens unike identifikator. Vær oppmerksom på at det er nødvendig å ha en 'Org'. prefiks for workloadName, slik at navnet består av to ord med «.»-skilletegn, for eksempel Org.MyWorkload. Andre prefikser er ugyldige og vil føre til en opplastingsfeil. Dette fremtvinges i følgende scenarioer – utviklingstilkobling, testopplasting.

Versjonselement

Manifestversjonen bør være SemVer-kompatibel .

CloudServiceConfiguration-element

Tjenestekonfigurasjonen for arbeidsbelastningen, for øyeblikket støttes bare én konfigurasjon.

Microsoft Entra ID [Azure Active Directory (AAD)] Programkonfigurasjon

Delen <AADApp> setter opp Microsoft Entra ID [Azure Active Directory (AAD)]-program for godkjennings- og godkjenningsprosesser. Representerer AppId den unike identifikatoren for programmet, RedirectUri angir URI-en som Microsoft Entra ID sender godkjenningssvaret til, og ResourceId punktene til den unike identifikatoren for ressursen programmet har tilgang til. Hvis du vil ha mer kontekst om hva ResourceId, AppIdog RedirectUri representerer, kan du referere til godkjenningsdokumentasjonen.

<AADApp>
    <AppId>YourApplicationId</AppId>
    <RedirectUri>YourRedirectUri</RedirectUri>
    <ResourceId>YourResourceId</ResourceId>
</AADApp>

Se godkjenningsdokumentasjonen for en dypere forståelse av AppId, ResourceIdog RedirectUri deres betydning i sammenheng med godkjenningsprosesser.

ServiceEndpoint-elementer

Representer konfigurasjonen av et bestemt logisk endepunkt, for eksempel bakendepunktet, som inkluderer implementering for element-API-er og jobb-API-er.

  • Konfigurasjonen for arbeidsbelastningens serverdelendepunkt sier url-adressen for serverdel for arbeidsbelastningen.
<ServiceEndpoint>
    <Name>Workload</Name>
    <Url>YourWorkloadBackendUrl</Url>
    <IsEndpointResolutionService>...
    <EndpointResolutionContext>...
</ServiceEndpoint>
  • <IsEndpointResolutionService> og <EndpointResolutionContext> angis basert på om endepunktet implementerer arbeidsbelastnings-API-en eller bare endepunktoppløsningen.
  • Det løste endepunktet som returneres fra tjenesten, må oppfylle følgende krav:
    • Domenet til det løste endepunktet må samsvare med domenet til ressurs-ID-en som ble funnet i WorkloadManifest.xml.
    • Url-adressen for det løste endepunktet kan ha opptil seks ekstra underdomener før hoveddomenet.
    • Et hvilket som helst underdomene etter det første segmentet må tilhøre listen over bekreftede domener for utgiverleieren.

Eksempel

URL-adresse for ressurs-ID:https://contoso.com/fe/be/Org.WorkloadSample (der domenet er contoso.com)

Bekreftede domener i tenant:contoso.com, be.contoso.com, eastus.be.contoso.com

Gyldige løste endepunkter:

  • api.eastus.be.contoso.com
  • be.contoso.com
  • api.be.contoso.com

Ugyldige løste endepunkter:

  • api.eastus.fe.contoso.com (ugyldig fordi eastus.fe.contoso.com det ikke er et bekreftet domene)
  • contoso-dev.com (ugyldig fordi contoso-dev.com det ikke er et bekreftet domene, og samsvarer heller ikke med hoveddomenet for ressurs-ID-en)
  • Hvis du vil ha mer informasjon om hvordan du bruker API-en for arbeidsbelastningsklienten for endepunktoppløsning, kan du se Endpoint Resolution.

Merk

Endepunktoppløsning for Frontend støttes ikke.

Elementmanifest – viktige manifestkomponenter

Manifestet, hvis struktur er definert av ItemDefinition.xsd, skisserer kjerneattributter for et arbeidsbelastningselement, for eksempel navn og jobbdefinisjoner.

SchemaVersion-attributt

Representerer Fabric's ItemDefinition.xsd publiserte versjon.

TypeName-attributt

Elementets unike identifikator.

Konfigurasjon av jobbplanlegging

Inndelingen <JobScheduler> omfatter ulike elementer som definerer virkemåten og innstillingene for jobbplanlegging, sporing og administrasjon.

  • <OnDemandJobDeduplicateOptions> og <ScheduledJobDeduplicateOptions>: Definer dedupliseringsalternativer for henholdsvis behovsbetingede og planlagte elementjobber. Alternativene inkluderer None (ingen deduplication), PerItem (én jobbkjøring for samme element og jobbtype) og PerUser (én jobbkjøring for samme bruker og element).
  • <ItemJobTypes>: Inneholder konfigurasjoner for ulike elementjobbtyper.
  • <ItemJobType>: Beskriver en bestemt jobbtype.
  • <Name>: Navnet på jobbtypen. Må bruke elementets navn som prefiks.

La oss for eksempel vurdere eksempelarbeidsbelastningen vår, som inkluderer tre bestemte jobber som er definert i inndelingen <ItemJobTypes> :

<JobScheduler>
    <OnDemandJobDeduplicateOptions>PerItem</OnDemandJobDeduplicateOptions>
    <ScheduledJobDeduplicateOptions>PerItem</ScheduledJobDeduplicateOptions>
    <ItemJobTypes>
    <ItemJobType Name="Org.WorkloadSample.SampleWorkloadItem.ScheduledJob" />
    <ItemJobType Name="Org.WorkloadSample.SampleWorkloadItem.CalculateAsText" />
    <ItemJobType Name="Org.WorkloadSample.SampleWorkloadItem.CalculateAsParquet" />
    </ItemJobTypes>
</JobScheduler>
  • CalculateAsText Job : Denne jobbtypen håndterer tekstbaserte beregninger, tar Operand1 og Operand2utfører den valgte operasjonen og lagrer resultatet i lakehouse.
  • CalculateAsParquet Job : Spesielt skreddersydd for å arbeide med parquet-data, tar Operand1 denne jobbtypen også, og Operand2utfører den valgte operasjonen, og lagrer resultatet i lakehouse, etter Parquet-dataformatet. Se veiledning for overvåkingshub hvis du vil ha mer informasjon om jobber og relatert konfigurasjon.

Sammendrag fungerer arbeidsbelastningen og elementmanifestene som grunnleggende dokumenter for å legge til egendefinerte arbeidsbelastninger i Fabric. Godkjenningsprosessen utløser en enkel sekvens av handlinger: opplasting, analyse og registrering, som garanterer riktig konfigurasjon og effektiv arbeidsbelastningsadministrasjon i Azure-økosystemet.