Jaa kautta


Muuttujakirjaston integrointi putkistoihin

Muuttujakirjasto on Microsoft Fabricin uusi kohdetyyppi, jonka avulla käyttäjät voivat määrittää ja hallita muuttujia työtilatasolla, joten niitä voidaan pian käyttää erilaisissa työtilakohteissa, kuten putkissa, muistikirjoissa, lakehousen pikakuvakkeessa ja muissa. Se tarjoaa yhtenäisen ja keskitetyn tavan hallita määrityksiä, mikä vähentää kiinteästi koodattuja arvoja ja yksinkertaistaa CI/CD-prosesseja, mikä helpottaa kokoonpanojen hallintaa eri ympäristöissä.

Muuttujakirjaston käyttäminen putkien kanssa

  1. Siirry työtilaasi ja luo uusi kohde.

    Näyttökuva, jossa näkyy, mihin uusi kohde lisätään Fabric-työtilassa korostettuna.

  2. Suodattimen avulla voit etsiä muuttujakirjastoa tai vierittää alaspäin Kehitä tietoja -osaan.

    Näyttökuva, jossa näkyy uuden muuttujakirjastokohteen suodatin.

  3. Valitse Muuttujakirjasto luodaksesi uuden muuttujakirjaston. Valitse nimi ja valitse sitten Luo.

    Näyttökuva, jossa näkyy uusi muuttujakirjaston kohde, jossa on määritetty nimi ja Luo-painike korostettuna.

  4. Kun Muuttujakirjasto on luotu, siirryt aloitussivulle. Napsauta + Uusi lisätäksesi uuden muuttujan.

    Näyttökuva, jossa näkyy uuden muuttujakirjaston kohteen aloitussivu.

  5. Kun lisäät uuden muuttujan, voit määrittää muuttujan ja määrittää nimi-, tyyppi- ja oletusarvojoukon. Voit myös lisätä huomautuksia.

    Näyttökuva, jossa näkyvät uudelle muuttujalle määritettävät määritykset.

  6. Lisää tarvittaessa vaihtoehtoisia arvojoukkoja (esimerkiksi eri käyttöönottoputkiympäristöjen eri arvot). Kun olet asettanut nimen ja klikannut Luo, voit muokata muuttujien arvoja ja valita arvojoukon, jonka haluat aktivoida.

    Näyttökuva, jossa korostetaan, mihin muuttujalle lisätään uusia arvojoukkoja.

    Näyttökuva, jossa näkyy, miten uudelle arvojoukolle lisätään nimi.

  7. Tallenna muutoksesi, kun olet valmis.

Kuvakaappaus, jossa näkyy Tallentaa -painike korostettuna vasemmassa yläkulmassa.

Muuttujakirjaston muuttujien käyttäminen jaksossa

  1. Jos haluat käyttää muuttujakirjastomuuttujaa putkessasi, luo uusi putki tai siirry olemassa olevaan jaksoon.

    Näyttökuva, jossa korostetaan Luo uusi kohde -painike vasemmassa yläkulmassa ja putkilinjan kohde korostettuna.

  2. Putkessa sinun on luotava viittaus muuttujakirjaston muuttujamuuttujaan alapaneelissa.

    Näyttökuva, jossa korostetaan Kirjastomuuttujat-välilehteä ja +Uusi-painiketta putkilinjan pohjan alapaneelissa.

  3. Kun olet napsauttanut + Uusi, avautuu ponnahdusikkuna, joka näyttää kaikki muuttujakirjastosi. Tämän valitsimen avulla voit valita muuttujakirjastomuuttujan ja napsauttaa OK.

    Näyttökuva, jossa näkyy +Uusi-painike Kirjastomuuttuja -välilehdessä korostettuna.

    Näyttökuva, jossa näkyy muuttujavalitsimessa valittu kirjastomuuttuja

    Näyttökuva, jossa näkyy uuden kirjastomuuttujaviittauksen määritysjoukko.

  4. Kun olet lisännyt kirjastomuuttujaviittaukset, lisää putkitoiminnot. Klikkaa aktiviteettiasetuksissa Lisää dynaamista sisältöä sen asetuksen kohdalla, jonka haluat parametroida.

    Näyttökuva, jossa näkyy Lisää dynaamista sisältöä korostettuna hakuaktiviteetin asetuksissa.

  5. Lausekkeen muodostin avautuu. Jos et näe Kirjastomuuttujat-kohtaa, napsauta Funktiot-kohdan vieressä olevia 3 pistettä ja valitse Kirjastomuuttujat.

    Näyttökuva, jossa näkyy lausekkeen muodostimen Funktiot-kohdan vieressä olevat 3 pistettä ja korostettuna Kirjastomuuttujat-välilehti.

  6. Napsauta kirjastomuuttujan viittausta lisätäksesi uuden lausekkeen lausekkeen rakentajaan. Napsauta sitten OK lisätäksesi lausekkeesi.

    Näyttökuva, jossa näkyy kirjastomuuttujan viittaus korostettuna lausekkeen muodostimeen lisättäväksi.

    Näyttökuva, jossa näkyy lausekkeen muodostimessa määritetty lauseke.

  7. Näet nyt, että dynaaminen sisältö lisätään toimintoasetukseen.

    Näyttökuva, jossa näkyy lauseke, joka on määritetty dynaamiseksi sisällöksi hakuaktiviteettiasetuksissa.

  8. Voit esikatsella dataa klikkaamalla Esikatsele dataa. Tämä avaa uuden ruudun, joka näyttää kirjastomuuttujan arvon. Napsauta OK saadaksesi esikatselun tiedoistasi.

    Näyttökuva, jossa näkyy esikatselutietojen vaihtoehto.

    Näyttökuva, jossa näkyy esikatselutietoruutu.

  9. Tallenna ja suorita putki normaalilla tavalla. Näet, että välitetty arvo on muuttujakirjastossa aktiivinen määritetty arvo.

    Näyttökuva, jossa näkyvät Tallenna ja suorita -asetukset korostettuina putken pohjalla.

Tunnetut rajoitukset

Seuraavat tunnetut rajoitukset koskevat muuttujakirjaston integrointia Microsoft Fabricin Data Factory -putkiin:

  • Muuttujakirjasto tukee tietotyyppeinä totuusarvoa, päivämäärä/aika-, guid-, kokonaisluku-, luku- ja merkkijonotyyppiä. Putkessa näet Boolen Bool-tyyppinä, Datetime merkkijonotyyppinä, Guid merkkijonotyyppinä, Integer-luku Int-tyyppinä ja String merkkijonotyyppinä. Numerotyyppejä ei tueta putkissa.
  • Ulkoisen yhteyden parametrointia tuetaan putkistoihin integroidulla muuttujakirjastolla. Sinun on kuitenkin etsittävä yhteyden GUID-tunnus asetukset-kohdasta | Hallinnoi yhteyksiä ja yhdyskäytäviä. Sieltä löydät yhteytesi GUID-tunnuksen valitsemalla Asetukset yhteytesi nimen vierestä.