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

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

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

  • Vie ADF:n globaalit parametrit
  • Luo työtilamuuttujat Fabric-ohjelmassa
  • Päivitä putkilausekkeet
  • Validoi käyttäytyminen

Ymmärrä Fabric-muuttujakirjasto

Fabric-muuttujakirjasto tallentaa työtilatason arvoja, joihin voit viitata putkien 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 ADF:n globaalit parametrit, Fabric-muuttujat tarjoavat tiukemman turvallisuuden, helpomman uudelleenkäytön ja paremmat hallintakontrollit. Voit käyttää niitä kaikkiin Fabric-esineisiin. Lisätietoja löytyy kohdasta Aloita muuttujakirjastoista.

Siirrä ADF:n globaalit parametrit Fabric-muuttujakirjastoon

  1. Vie ADF:n 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ä.

    Käy läpi ADF:n globaalit parametrityypit (merkkijono, int, bool jne.) ja vertaa niitä Fabric muuttujakirjastotyyppeihin. 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 +Uusi muuttuja ja jokainen ADF:n 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 ADF-parametrit, kuten alue- tai vuokralaisen nimi, yksi yhteen muuttuvien kirjastomerkintöjen välillä.

  • 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:

  • Kumpikaan sisäänrakennettu päivityskokemus eikä PowerShell-migraatiotyökalu siirrä 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ö

  • Last updated on