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).

item reference -muuttuja on kehittynyt muuttujatyyppi, jota käytetään Fabric Variable Libraryssa säilyttämään viittaus olemassa olevaan Fabric-kohteeseen—kuten lakehouseen, notebookiin tai dataputkistoon, tallentamalla työtilan ID:n ja kohteen ID:n. Tämän tyyppinen muuttuja mahdollistaa sisäisen yhteyden parametrisoinnin, jolloin kehittäjät voivat dynaamisesti linkittää kohteita tiettyihin Fabric-kohteisiin käyttöönoton tai työtilan kontekstin perusteella.

Käyttö

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

  1. Kirjaudu sisään 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

Kohteen viitemuuttujan 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 kehittäjille, 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

Hallinnoi muuttujakirjastoa koodina. Käyttämällä Git- tai REST-rajapintoja voit käsitellä kohdeviitemuuttujia selkeän JSON-muodon kautta. Kaikki muuttujat näkyvät muuttujakirjaston määrittelytiedostossa (tallennettuna Gitissä, yleensä .json), jossa luetellaan ominaisuuksia kuten nimi, tyyppi ja arvo.

Kohteen viitemuuttujalle (staattiselle) 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 Fabric-ohjelmaan.
  • 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 alkioviitemuuttujan muuttujakirjastosta Fabric:ssa.
  • 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:n tuotteet, kuten Dataflow Gen1, eivät tällä hetkellä ole tuettuja.

Lisätiedot

Muuttujakirjasto mahdollistaa CI/CD:n Fabric-sisällölle eri ympäristöissä (Dev, Test, Prod) käyttämällä elementtireferenssimuuttujia vaihekohtaisissa konfiguraatioissa. Pidä mielessä seuraavat asiat:

  • Kohdeviittaukset on 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 arvosettejä jokaiselle tasolle ja aktivoi oikea joukko manuaalisesti tai API-skriptien avulla.

Lisätietoja löytyy arvojoukoista muuttujakirjastoissa.

Liittyvä sisältö

  • Last updated on