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.

Tuetut kohteet

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

Kuvakaappaus esineviitemuistikirjasta.

Note

Notebook ei %%configure ole tuettu.

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.

Tarvittavat oikeudet tuoteviittausten luomiseen/käyttöön

Item Reference -muuttujien käyttö sisältää kaksi käyttöoikeuskerrosta:

  • Luo/muokkaa – Vaikka mikä tahansa työtilan osallistuja voi muuttaa muuttujien arvoja, Element-viitemuuttuja sallii käyttäjien asettaa arvoksi vain sellaisia kohteita, joille heillä on lukuoikeudet. Tämä koskee mitä tahansa arvoa, oletuksena aktiivista arvojoukkoa tai muita arvojoukkoja. Huomioi, että kun tallennetaan muuttujakirjaston kohdetta, käyttäjälle, joka tallentaa, tehdään käyttöoikeustarkistus kohteen viitemuuttujien aktiivisista arvoista, vaikka arvot pysyisivät ennallaan.
  • Käytä item ref -muuttujaa – Kun käyttäjä luo tai päivittää viitettä muuttujaan kuluttajatuotteessa, käyttäjät eivät voi asettaa viittausta kohteen viitemuuttujaan, ellei heillä ole vähintään LUKU-oikeutta kyseiselle kohteelle aktiivisessa arvojoukossa.

Luvan validointi

Käyttöoikeuksien validointi käynnistyy seuraavissa käyttötapauksissa:

  • Muokkaa muuttujakirjaston alkiota, jossa on kohteen viitemuuttujia Muokkauksessa varmistamme sekä viittaavien alkioiden olemassaolon että että käyttäjän vähintään lukuoikeudet niihin, kaikille aktiivisen arvojoukon alkioviitearvoille seuraavissa tilanteissa:

  • UI - Muuttujakirjaston kohteen SAVE-vaiheessa käyttäjälle, joka tallentaa kohteen, kohdeviitemuuttujien aktiiviset arvot, suoritetaan käyttöoikeustarkistus, vaikka arvot pysyisivät ennallaan.

  • API:t/GIT-päivitys – Käyttöoikeuksien validointi tehdään päivityksen aikana ja epäonnistuu, jos ei ole lukuoikeutta kohteen viitteen aktiiviseen arvoon päivitetyssä työtilassa.

  • Käyttöönotto – Muuttujakirjaston kohteen käyttöönotto epäonnistuu, jos kohdetyötilan Item refin aktiiviseen arvoon ei ole lukuoikeutta.

  • Katso kohdeviitteet lisätietoja muuttujakirjaston sivulla (vain käyttöliittymä). Käyttäjät, joilla on pääsy muuttujakirjastoon (WS-katseluohjelma tai uudempi), mutta joilla ei ole oikeuksia viitatun alkiomuuttujan kohteelle, eivät näe tietojaan käyttöliittymässä. Sen sijaan he näkevät esine-ID:n ja hover-viestin, eivät yksityiskohtia.

Kuvakaappaus oikeuksista.

  • Luo/muokkaa kohteen viitemuuttuja

    • UI – Kun päivitetään minkä tahansa arvojoukon arvoa (oletus tai muu), käyttäjä voi valita listasta alkiota, jossa näkyy vain ne kohteet, joihin hänellä on vähintään lukuoikeus.
    • API:t/GIT-päivitys tai käyttöönotto – katso yllä oleva Edit Variable -kirjaston kohta.

  • Tuotteen viitemuuttujan käyttö kulutustuotteessa

    • UI - Luo Viittauksen muuttujaan - Kun luot kohteeseen viittauksen 'Item reference' -muuttujaan 'Valitse muuttuja' -käyttöliittymän (kuten Lakehouse- ja Data pipeline -pikakuvakkeissa), vahvistetaan, että viitteen luojalla on vähintään lukuoikeus 'item reference' -muuttujien kohteisiin (validointi koskee vain aktiivisia arvoja). Jos ei, käyttäjä näkee vain esineiden ID:n.

Käyttäytyminen CI/CD-putkissa ja käyttöönottovaiheissa

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:

Staattiset viittaukset

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

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

Liittyvä sisältö

  • Last updated on