Jaa

Kohdeviitemuuttujan tyyppi (esikatselu)

Joustavuuden ja skaalautuvuuden parantamiseksi otamme käyttöön kehittyneitä muuttujia nykyisten perusmuuttujatyyppien rinnalle. Nämä kehittyneet muuttujat on suunniteltu täyttämään keskeiset vaatimukset, kuten ulkoisten ja sisäisten yhteyksien parametrisoinnin (esim. Snowflake, AWS, OneLake).

Kohteen viitemuuttuja on kehittynyt muuttujatyyppi, jota käytetään Fabric Variable Libraryssa säilyttämään viittaus olemassa olevaan Fabric-kohteeseen – kuten lakehouseen, notebookiin tai dataputkeen – tallentamalla sen työtilan ID ja kohde-ID. Tämän tyyppinen muuttuja mahdollistaa sisäisen yhteyden parametrisoinnin, jolloin kehittäjät voivat dynaamisesti linkittää kohteita tiettyihin Fabric-elementteihin käyttöönoton tai työtilan kontekstin perusteella.

Käyttö

Alkioreferenssimuuttujaa voidaan käyttää kuten muita muuttujakirjaston muuttujia.

  1. Kirjaudu Microsoft Fabriciin
  2. Siirry työtilaasi ja muuttujakirjastoon
  3. Ylhäällä valitse + Uusi muuttuja
  4. Anna muuttujalle nimi, valitse tyypin kohdeviite ja klikkaa sitten ... valitaksesi arvon
  5. Tämä avaa dialogin, jolla voi valita halutun kohteen. Näet kaikki esineet, joihin sinulla on oikeudet, ja ne ovat valittavissa. Käytä vasemmalla olevaa resurssienhallintaohjelmaa suodattaaksesi listan työtilan mukaan. Käytä oikean yläkulman suodatinta suodattamaan tyypin mukaan.

Kuvakaappaus saatavilla olevista esineistä tuotteen viitteeksi. 6. Kun valinta on valittu, se näkyy varlib-sivulla näin – vain luku -komponenttina, jossa näkyy kohteen nimi.

Kuvakaappaus esineviittauksesta.

Jos sinun täytyy muokata kohdeviitettä tai tarkistaa arvo:

  • Lisätietoja saat klikkaamalla arvoa
  • Muokataksesi tätä arvoa tai muiden arvojoukkojen arvoja, klikkaa arvon vieressä olevaa painiketta.

Kuvakaappaus esineviittauksen ponnahdusikkunasta.

Miten se toimii

Item Reference -muuttujan arvo on käytännössä staattinen osoitin Fabric-kohteeseen, joka tunnistetaan Workspace ID + Item ID:llä. Arvo tallennetaan pariksi GUID-tiedostoja, jotka vastaavat kohdekohteen työtilaa ja itse kohdetta. Esimerkiksi viite voidaan tallentaa sisäisesti seuraavasti:

  • WorkspaceID = aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
  • ItemID = 00aa00aa-bb11-cc22-dd33-44ee44ee44ee

Nämä kaksi ID:tä yhdessä tunnistavat viitatun kohteen yksikäsitteisesti.

Pidä mielessä seuraavat asiat työskennellessäsi tuoteviittauksien kanssa:

  • Item references mahdollistaa sisäisen yhteyden parametrisoinnin, jolloin kehittäjät voivat dynaamisesti linkittää kohteita tiettyihin Fabric-resursseihin käyttöönoton tai työtilan kontekstin perusteella.
  • Viittaus on staattinen, osoittaen tiettyyn kohteeseen eikä automaattisesti säädettävä ympäristöjen välillä.
  • Kenttäkohtaisissa variaatioissa käytetään arvojoukkoja, joissa jokainen joukko voi osoittaa eri staattiseen kohteeseen (esim. eri järvitalot per kenttä).
  • Kaikkien arvojoukkojen arvojen tulisi olla samaa alkiotyyppiä yhteensopivuuden varmistamiseksi ja virheiden estämiseksi. Emme kuitenkaan pakota saman esinetyypin käyttöä arvojoukoissa.

Esitys Gitissä ja API:ssa

Muuttujakirjastoa hallinnoidaan koodina. Git- tai REST-rajapintojen avulla Item Reference -muuttujilla on selkeä JSON-muoto. Kaikki muuttujat näkyvät muuttujakirjaston määrittelytiedostossa (tallennettuna Gitissä, yleensä .json), jossa luetellaan ominaisuuksia kuten nimi, tyyppi ja arvo.

Item Reference (Static) -muuttujalle arvo on rakenteellinen data työtilalle ja kohdetunnisteille. Esimerkki:


{
 "name": "MyDataLake",
 "note": "",
 "type": "ItemReference",
 "value": {
  "itemId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
  "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
 }
}

Muista seuraavat asiat API:n kautta työskennellessäsi:

  • Vain ID:t tallennetaan; nimet ja metatiedot haetaan ajonaikaisesti tai välimuistitetaan Fabricissa.
  • API:n kautta luoda/päivittäessä annat työtilan ja esineiden ID:t. Virheelliset ID:t aiheuttavat virheitä.

Tuetut kohteet

Seuraavassa on luettelo kohteista, joita tällä hetkellä tuetaan item referencen avulla:

Note

Notebook ei %%configure ole tuettu.

Python-koodiesimerkki

Seuraava koodiesimerkki näyttää, miten kohdeviitettä käytetään python-skriptissä.

var_ref = "$(/**/VarLibItem/itemReference)"
var_obj = notebookutils.variableLibrary.get(var_ref)
workspace_id = var_obj.get("workspaceId").value()
item_id = var_obj.get("itemId").value()
print(workspace_id)
print(item_id)

Koodilla voidaan suorittaa seuraavia toimintoja:

  • Ratkaisee Item Reference -muuttujan Fabric-muuttujakirjastosta
  • Hae metatietoobjektin kyseiselle viitatulle kohteelle
  • Poimee työtilan ID:n ja kohteen ID:n
  • Tulostaa ne, jotta niitä voidaan käyttää ohjelmallisesti.

Käyttöoikeudet, jotka vaaditaan kohdeviitemuuttujien luomiseen/käyttöön

Kohdeviitemuuttujien käyttö sisältää kaksi käyttöoikeuskerrosta:

  • Luo ja muokkaa kohteen viitemuuttujaa: Työntekijät, joilla on Contributor tai sitä korkeammat roolit työtilassa, voivat luoda ja muokata muuttujia kirjastossa, kun taas Viewerit ovat vain luku -tilassa.
  • Kohdeviitemuuttujan käyttö: Muuttujakirjaston oikeuksien lisäksi sinulla täytyy olla vähintään lukuoikeus siihen kohteen viitemuuttujaan , johon aiot viitata siihen.

Lisätietoja käyttöoikeuksista ja käyttöoikeuksien validoinnista löytyy kohdasta Muuttujakirjaston käyttöoikeudet

Rajoitukset

Tällä hetkellä voit viitata vain kangasesineisiin ja semanttisiin malleihin. Muut Power BI -tuotteet, kuten Datamartit ja Dataflow Gen1, eivät tällä hetkellä ole tuettuja.

Lisätiedot

Variable Library mahdollistaa CI/CD:n Fabric-sisällölle eri ympäristöissä (Dev, Test, Prod) käyttäen Item Reference -muuttujia vaihekohtaisissa konfiguraatioissa. Muista seuraavat seikat:

  • Kohdeviittaukset ovat sidottu tiettyyn työtilaan ja kohteen ID:hen.
  • Kun siirrytään uuteen vaiheeseen, nämä viittaukset osoittavat edelleen alkuperäiseen työtilaan, ellei niitä päivitetä manuaalisesti.
  • Käytä useita Value-Sets jokaisessa vaiheessa ja aktivoi oikea joukko manuaalisesti tai API-skriptien avulla.

Lisätietoja löytyy arvojoukoista muuttujakirjastoissa.

Liittyvä sisältö

  • Last updated on