Convert Azure Data Factory global parameters to Fabric Data Factory variable libraries

Fabric käyttää muuttuvia kirjastoja työtiloissa määritelläkseen vakioita putkistoissa sekä muissa datatehtaiden ja Fabric-kohteissa. Voit siirtää Azure Data Factory -globaalit parametrit Fabric-muuttujakirjastoihin muutamalla manuaalisella vaiheella.

Tämä opas opastaa sinua prosessin läpi:

  • Vie Azure Data Factory -globaalit parametrit
  • Luo työtilamuuttujat Fabric-ohjelmassa
  • Päivitä putkilausekkeet
  • Validoi käyttäytyminen

Ymmärrä Fabric-muuttujakirjasto

Fabric:n muuttujakirjasto tallentaa työtilatason arvoja, joita voit viitata putkiston ja toimintojen välillä. Se tukee tyyppejä kuten merkkijono, luku ja totuusarvo sekä turvalliset arvot salaisuuksille. Voit versioida muuttujakirjastoja ja ottaa niitä käyttöön eri ympäristöissä käyttöönottoputkien avulla.

Toisin kuin Azure Data Factory -globaalit parametrit, Fabric-muuttujat tarjoavat tiukemman turvallisuuden, helpomman uudelleenkäytön ja paremmat hallintahallinnat. Voit käyttää niitä kaikkiin Fabric-esineisiin. Lisätietoja löytyy kohdasta Aloita muuttujakirjastoista.

Migrate Azure Data Factory global parameters to Fabric variable library

  1. Vie Azure Data Factory -globaalit parametrit.

    1. Azure Data Factory Studio mene Manage>Global Parameters. Kirjaa kunkin parametrin nimi, tyyppi ja arvo.
    2. Suuria migraatioita varten mene Manage>ARM template -kohtaan ja vie ARM-mallipohjat poimiaksesi parametrit ohjelmallisesti. Löydät ne mallikansiosta tehdaskansion alta, tiedostosta, joka päättyy ParametersForFactory

  2. Vertaa saatavilla olevia tyyppejä.

    Tarkista Azure Data Factory -globaalit parametrityypit (string, int, bool jne.) ja vertaa niitä Fabric-muuttujakirjaston tyyppeihin. Merkitse ylös mahdolliset tyyppierot, jotka saattavat vaatia muutoksia muuton aikana.

  3. Luo muuttujakirjasto Fabric.

    1. Fabric työtilassasi valitse + New Item ja valitse sitten Variable library.
    2. Luo kirjasto (esimerkiksi GlobalParams).
    3. Avaa uusi muuttujakirjastosi, valitse +New variable ja jokainen Azure Data Factory -globaali parametri muuttujana.

    Lisätietoja muuttujakirjastojen luomisesta löytyy kohdasta Aloita muuttujakirjastoilla.

  4. Päivitä siirretyt putkilausekkeet.

    Päivitä globaalit parametriviittaukset, kuten @globalParameters('ParamName') muuttujakirjaston viitteisiin, kuten @pipeline.libraryVariables.ParamName.

    Päivitä kaikki aktiviteettilausekkeidesi, yhteysmerkkijonot, skriptiargumenttisi, suodatinlogiikkasi ja tietoaineiston ominaisuudet. Lisätietoja löytyy kohdasta Variable library integration with data pipelines.

  5. Validoi putkiston käyttäytyminen.

    Suorita validointi ja testaussuoritukset varmistaaksesi, että muuttujat ratkeavat oikein putkistossasi. Tarkista, että yhteydet, parametrien sidonnat ja turvallinen muuttujien käyttö toimivat odotetusti.

Yleiset muuttoreitit

Tässä on joitakin migraatiomalleja, joita voisit käyttää muuntaessasi globaaleja parametreja muuttujakirjastoiksi:

  • Suora kartoitus — Yksinkertaiset Azure Data Factory -parametrit, kuten alue- tai vuokralaisen nimi, yhdistävät yhden muuttujakirjaston merkintöihin.

  • Ympäristökohtaiset kirjastot — Yhden kirjaston sijaan luo useita kirjastoja (Global-Dev, Global-Test Global-Prod). Käyttöönottoputket voivat sitoa oikean kirjaston ympäristön mukaan.

  • Hybridimalli — Pidä jaetut vakiot muuttujakirjastossa, mutta siirrä ajokohtaista tietoa putkistoparametrien kautta.

Nykyiset rajoitukset

Tällä hetkellä on muutamia rajoituksia, jotka on hyvä huomioida:

  • Sisäänrakennettu päivityskokemus eikä PowerShell-päivitystyökalu päivitä globaaleja parametreja automaattisesti.
  • Linkitetyissä palveluissa tai putkistoissa, jotka viittaavat @globalParameters() siihen, lausekkeet eivät automaattisesti kirjoiteta uudelleen.
  • Fabric-yhteydet (Azure Data Factory -linkitettyjen palveluiden korvaaja) eivät tue parametrilausekkeita samalla tavalla. Sinun täytyy manuaalisesti kirjoittaa uudelleen kaikki dynaamiset parametrit, joita käytetään yhteysmääritteyksissä.

Parhaat käytännöt

Pidä nämä vinkit mielessä:

  • Sovita nimeämiskäytännöt ennen siirtymistä.
  • Vältä työtilan muuttujien ylikuormitusta. Käytä putkistoparametreja ajonaikaisten arvojen saamiseksi.
  • Käytä käyttöönottoputkia ympäristökohtaisten muuttujakirjastojen hallintaan.
  • Dokumentoi muuttujakirjastosi, jotta tiimin jäsenet tietävät, mitkä putket riippuvat mistä muuttujista.

Aiheeseen liittyvä sisältö

  • Viimeksi päivitetty