Jaa

Kuormituksen luettelotiedosto

  • Artikkeli

Yleiskuvaus

- WorkloadManifest.xml tiedostot ja Item.xml -tiedostot tarvitaan kuormituksen määrittämiseen Fabricissa. Ne säilyttävät määrityksen kuormituksen ja kuormituksen kohteiden perusasetukset, ja ne toimivat kuormituksen määrittämisen ja hallinnan oppaana, auttaen määrittämään, jakamaan ja tallentamaan olennaisia kuormitustietoja Fabric-integroinnin sujuvaa integrointia varten.

Mallisäilössämme .nupkg luodaan tiedosto xml-tiedostoista, jotka sijaitsevat -kansiossa src/Packages/manifest koontiprosessin aikana. Tämä pakattu tiedosto sisältää kaikki tarvittavat tiedot kuormituksestasi. Tiedostossa workload-dev-mode.json on kenttä nimeltä ManifestPackageFilePath , jonka pitäisi osoittaa tähän juuri luotuun .nupkg tiedostoon.

Lataus- ja rekisteröintiprosessi

  1. Käyttäjän todentaminen: Kehitysvaiheessa, kun malli on suoritettu, todennus käynnistää lataus- ja rekisteröintiprosessin. Tämä varmistaa kuormituksen oikean liitoksen käyttäjätietoihisi.
  2. Luettelotiedoston jäsennys: Palveluun ladattu luettelo jäsennys jäsentää sen rakenteen ja sisällön vahvistamiseksi. Tämä vaihe varmistaa, että luettelotiedosto on muotoiltu oikein ja valmis jatkokäsittelyä varten.
  3. Kuormituksen rekisteröinti: Jos jäsennys onnistuu, kuormitus rekisteröidään Fabricissa. Olennaiset määritystiedot, kuten kuormituksen tunnus, tallennetaan Fabric-tietokantaan, mikä mahdollistaa tehokkaan kuormituksen hallinnan.

Kuormituksen luettelo – avainluettelon osat

Luettelotiedosto, jonka rakenteen määrittää WorkloadDefinition.xsd, määrittää kuormituksen ydinmääritteet, kuten nimen, sovelluksen ja päätepisteet.

SchemaVersion-määrite

Edustaa Fabricin WorkloadDefinition.xsd-julkaistua versiota.

WorkloadName-määrite

Kuormituksesi yksilöllinen tunniste. Huomioi, että organisaatio vaaditaan. workloadName-etuliite, joka sisältää kaksi sanaa ,.-erottimella, esim. 'Org.MyWorkload'. Muut etuliitteet ovat virheellisiä ja aiheuttavat latausvirheen. Tämä pakotetaan käyttöön seuraavissa skenaarioissa – kehitysyhteys, testin lataaminen.

Versioelementti

Luettelotiedoston version on oltava SemVer-yhteensopiva .

CloudServiceConfiguration Element

Kuormituksen palvelumääritystä, tällä hetkellä vain yhtä määritystä tuetaan.

Microsoft Entra ID [Azure Active Directory (AAD)] Application Configuration

Osiossa <AADApp> määritetään Microsoft Entra ID [Azure Active Directory (AAD)]-sovellus todentamis- ja valtuutusprosesseille. AppId edustaa sovelluksesi yksilöivää tunnusta, määrittää URI-tunnuksen, RedirectUri johon Microsoft Entra -tunnus lähettää todennusvastauksen, ja ResourceId pisteet sen resurssin yksilölliseen tunnisteeen, jota sovellus käyttää. Lisätietoja siitä, mitä ResourceId, AppIdja RedirectUri mitä edustat, on todennusdokumentaatiossa.

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

Todennusdokumentaatiosta saat lisätietoja -ResourceIdAppId, - ja RedirectUri -merkityksestä todennusprosessien kontekstissa.

ServiceEndpoint-elementit

Edustaa tietyn loogisen päätepisteen määritystä, esimerkiksi taustan päätepistettä, joka sisältää kohteen CRUD- ja töiden ohjelmointirajapintojen toteutuksen.

  • Kuormituksen taustapäätepisteen määrityksessä ilmoitetaan kuormituksesi tausta-URL-osoite.
<ServiceEndpoint>
    <Name>Workload</Name>
    <Url>YourWorkloadBackendUrl</Url>
    <IsEndpointResolutionService>...
    <EndpointResolutionContext>...
</ServiceEndpoint>

Muistiinpano

Edustan päätepisteiden tarkkuutta ei tueta.

Kohteen luettelo – avainluettelon osat

Luettelotiedosto, jonka rakenteen määrittää ItemDefinition.xsd, määrittää kuormituksen kohteen ydinmääritteet, kuten nimen ja työn määritykset.

SchemaVersion-määrite

Edustaa Fabricin ItemDefinition.xsd-julkaistua versiota.

TypeName-määrite

Kohteesi yksilöllinen tunniste.

Kuormituksen ajoitustoiminnon määritys

- <JobScheduler> osassa on eri elementtejä, jotka määrittävät työn ajoituksen, seurannan ja hallinnan toiminnan ja asetukset.

  • <OnDemandJobDeduplicateOptions> ja <ScheduledJobDeduplicateOptions>: Määritä pyydettäessä tehtävien ja ajoitettujen nimiketöiden deduplicaatioasetukset. Vaihtoehtoja ovat None (ei deduplication-funktiota), PerItem (yksi työ suoritetaan samalle kohteelle ja työtyypille) ja PerUser (yksi työ suoritetaan samalle käyttäjälle ja kohteelle).
  • <ItemJobTypes>: Sisältää eri nimiketyötyyppien määritykset.
  • <ItemJobType>: Kuvailee tietyn työtyypin.
  • <Name>: Työtyypin nimi. Kohteen nimeä on käytettävä etuliitteenä.

Tarkastellaanpa esimerkiksi mallikuormitusta, joka sisältää kolme tiettyä osaa, jotka on määritetty - <ItemJobTypes> osassa:

<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 : Tämä työtyyppi käsittelee tekstipohjaiset laskutoimitukset, valitun toiminnon suorittamisen Operand1 ja Operand2tuloksen tallentamisen Lakehousessa.
  • CalculateAsParquet Job : Erityisesti räätälöity Parquet-tietojen käsittelyyn, tämä työtyyppi myös ottaa Operand1 ja Operand2, suorittaa valitun toiminnon ja tallentaa tuloksen Lakehouse-järjestelmään Parquet-tietomuodon mukaisesti. Lisätietoja töistä ja määrityksestä on valvontakeskuksen oppaassa .

Yhteenvetona Kuormitukset ja Kohdeluettelot toimivat perustason asiakirjojena mukautettujen kuormitusten lisäämiseksi Fabriciin. Todentamisprosessi käynnistää yksinkertaisen toimintosarjan: lataamisen, jäsentämisen ja rekisteröinnin, asianmukaisen määrityksen ja tehokkaan kuormituksen hallinnan Azure-ekosysteemissä.