Jaa


Käytä Fabric-muuttujakirjastoja Dataflow Gen2:ssa

Note

Lisätietoja tämän kyvykkyyden hyödyntämisestä jatkuvan integraation / jatkuvan käyttöönoton (CI/CD) tilanteissa saat lukemalla artikkelin CI /CD- ja ALM-ratkaisuarkkitehtuureista Dataflow Gen2 :ssa sekä päästä päähän -opas muuttujaviittauksista datavirtauksessa.

Fabric-muuttujakirjastot tarjoavat keskitetyn tavan hallita määritysarvoja Microsoft Fabric -kuormituksissa. Dataflow Gen2:n uuden integroinnin avulla voit viitata näihin muuttujiin suoraan tietovuossa, mikä mahdollistaa dynaamisen toiminnan eri ympäristöissä ja yksinkertaistaa CI/CD-työnkulkuja.

Edellytykset

Jos haluat käyttää Fabric-muuttujakirjastoja Dataflow Gen2:ssa, varmista seuraavat asiat:

Viitemuuttujat syötewidgettien avulla

Dataflow Gen2 -dialogeissa on syötewidget, jonka avulla voit valita, miten syötät kentän arvon. Tuetuissa dialogeissa voit valita muuttujia käyttämällä tätä widgettiä.

Kuvakaappaus syötewidgetistä suodatinrivivalikossa, jossa näkyy useita vaihtoehtoja syötettäväksi.

Note

Syötewidgetin käyttämiseksi View-välilehdeltä nauhalla, Parametrit-ryhmästä, valitse Aina salli. Kuvakaappaus aina salli -valintaruudusta nauhan Näy-välilehdellä syötewidgetin aktivoimiseksi.

Jotkut dialogit tukevat syötewidget-kokemusta ja Fabric-muuttujakirjastoja, kuten:

Kun valitset muuttujavaihtoehdon input-widgetissä, muuttujavalitsijan valinta ilmestyy. Tässä valintaikkunassa voit selata muuttujakirjastojasi ja niiden sisältämiä muuttujia.

Kuvakaappaus valintamuuttujan valintaikkunasta, joka näyttää kaikki saatavilla olevat kirjastot ja muuttujat nykyisessä työtilassa.

Kun olet valinnut muuttujan, valintaikkunassa näkyy kirjasto ja muuttujan nimi, jotta voit vahvistaa valintasi ennen sitoutumista.

Kuvakaappaus muuttujasta, jonka nimi on Ceiling, kirjastosta Oma kirjasto näkyy valittuna suodatinrivien valintaikkunassa.

Note

Kaikki Dataflow-kokemukset eivät tue syöttöwidgettiä. Tuettamattomissa kokemuksissa tai mukautetuissa tilanteissa käytä muuttujafunktioita manuaalisesti.

Muuttujafunktiot

Dataflow Gen2:ssa voit viitata muuttujaan käyttämällä seuraavia funktioita:

Tunnisteen, jonka annat jommallekummalle funktiolle, on käytettävä seuraavaa muotoa:

$(/**/LibraryName/VariableName)

Seuraavat esimerkit olettavat muuttujakirjaston nimeltä My Library ja merkkijonomuuttujan nimeltä My Variable:

Variable.ValueOrDefault("$(/**/My Library/My Variable)", "Sample")
Variable.Value("$(/**/My Library/My Variable)")

Oletusarvon käyttäminen auttaa Variable.ValueOrDefault varmistamaan, että kaava ratkeaa, vaikka kopioisit tai siirrät ratkaisun toiseen ympäristöön, jossa ei ole viitattua muuttujakirjastoa.

Vinkki

Tallenna jokainen muuttuja erillisenä kyselynä, joka ei vaadi vaiheistusta. Tämä lähestymistapa antaa sinun käyttää näitä arvoja dialogeissa, jotka tukevat kyselysyötettä , ja auttaa pitämään järjestelmällisen näkymän muuttujille datavirtassasi.

Huomioitavat asiat ja rajoitukset

Seuraavassa luettelossa esitellään tärkeitä rajoituksia ja toimintatapoja, jotka on pidettävä mielessä, kun käytät Fabric-muuttujakirjastoja Dataflow Gen2:n kanssa. Nämä rajoitukset vaikuttavat siihen, miten muuttujiin viitataan, arvioidaan ja miten niitä käytetään suunnittelun ja suorituksen aikana.

  • Työtilan vaikutusalue: Muuttujakirjastojen on sijaittava samassa työtilassa kuin tietovuo Gen2 CI/CD:n kanssa.

  • Viitesijainti: Muuttujia voidaan käyttää vain tietovuon Gen2:n mashup.pq-tiedostossa, jossa on CI/CD.

  • Ajonaikainen käyttäytyminen: Muuttujaarvot haetaan suoritusoperaation alussa ja ne säilyvät koko operaation ajan. Kirjaston muutokset Dataflow-suorituksen aikana eivät pysäytä tai vaikuta kyseiseen suoritukseen.

  • Oletusarvon käyttäminen: Kun käytät oletusarvoa funktion Variable.ValueOrDefault kautta, varmista, että oletusarvon tietotyyppi vastaa viitatun muuttujan tietotyyppiä.

  • Tuetut tyypit: Vain perustyyppiset muuttujat ovat tuettuja (boolean, datetime, guid, integer, number, ja string).

  • Kiinteät yhteydet: Muuttujat eivät voi muuttaa yhteystietoja. Yhteydet pysyvät kiinteinä luotuihin resurssipolkumäärityksiin.

  • Ohitusriski: Käyttäjät, joilla on oikeus muokata muuttujakirjastoja, voivat ohittaa muuttujien arvot, mikä saattaa vaikuttaa tietovuon tuloon.

  • Skeemakartoitus: Muuttujat eivät voi muokata kohderakenteen yhdistämismäärityksiä. Yhdistämismääritykset noudattavat luotuja asetuksia.

  • Historiatietojen näkyvyys: Historiahistorianäkymät eivät näytä linkkejä Dataflow Gen2:n ja sen viittaamien muuttujakirjastojen välillä.