Elementreferansevariabeltype (forhåndsvisning)

For å øke fleksibiliteten og skalerbarheten, introduserer vi avanserte variabler ved siden av de eksisterende grunnleggende variabeltypene. Disse avanserte variablene er designet for å møte viktige krav som parameterisering av eksterne og interne tilkoblinger (f.eks. Snowflake, AWS, OneLake).

En elementreferansevariabel er en avansert variabeltype som brukes i Fabric Variable Library for å holde en referanse til et eksisterende Fabric-element—for eksempel et lakehouse, notatbok eller datapipeline, ved å lagre dets arbeidsområde-ID og element-ID. Denne typen variabel muliggjør intern tilkoblingsparameterisering, slik at utviklere dynamisk kan koble elementer til spesifikke Fabric-elementer basert på distribusjonsfase eller arbeidsområdekontekst.

Bruk

En elementreferansevariabel kan brukes på samme måte som andre variabler i et variabelbibliotek.

1. Logg inn på Microsoft Fabric
2. Naviger til arbeidsområdet og variabelbiblioteket ditt
3. Øverst velger du + Ny variabel
4. Oppgi et navn på variabelen, velg elementreferanse for typen, og klikk deretter på ... for å velge en verdi
5. Dette åpner en dialog for å velge ønsket element. Du vil se alle elementene du har tillatelser til, tilgjengelige for valg. Bruk utforskeren til venstre for å filtrere listen etter arbeidsområde. Bruk filteret øverst til høyre for å filtrere etter type.

6. Når den er valgt, vil den vises slik på varlib-siden – som en skrivebeskyttet komponent som viser navnet på elementet.

Hvis du trenger å redigere en gjenstandsreferanse eller dobbeltsjekke verdien:

• For å se flere detaljer, klikk på verdien
• For å redigere denne verdien eller verdiene til andre verdisett, klikk på knappen ved siden av verdien.

Slik fungerer det

Verdien til en Item Reference-variabel er i hovedsak en statisk peker til et Fabric-element identifisert med Workspace ID + Item ID. Verdien lagres som et par GUID-er som tilsvarer målobjektets arbeidsområde og selve elementet. For eksempel kan en referanse lagres internt som:

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

Disse to ID-ene identifiserer sammen det refererte elementet entydig.

Husk følgende når du jobber med gjenstandsreferanser:

• Elementreferanser muliggjør intern tilkoblingsparameterisering, slik at utviklere dynamisk kan koble elementer til spesifikke Fabric-ressurser basert på distribusjonsfase eller arbeidsområdekontekst.
• Referansen er statisk, peker på en spesifikk gjenstand og justerer seg ikke automatisk på tvers av miljøene.
• For nivåspesifikke variasjoner, bruk verdisett, der hvert sett kan peke på et forskjellig statisk element (f.eks. forskjellige innsjøhus per nivå).
• Alle verdier på tvers av verdisett bør være av samme elementtype for å sikre kompatibilitet og forhindre kjørefeil. Vi håndhever imidlertid ikke at samme varetype skal være på tvers av verdisett.

Representasjon i Git og API-er

Variabelbiblioteket administreres som kode. Ved bruk av Git- eller REST-API-er har Item Reference-variabler et klart JSON-format. Alle variabler vises i definisjonsfilen til variabelbiblioteket (lagret i Git, vanligvis .json), og lister egenskaper som navn, type og verdi.

For en Item Reference (Statisk) variabel er verdien strukturerte data for arbeidsområde- og vare-IDer. Eksempel:

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

 

Husk følgende når du jobber via API:

• Kun ID-er lagres; navn og metadata hentes under kjøring eller caches i Fabric.
• Når du oppretter/oppdaterer via API, oppgir du arbeidsområde- og gjenstands-IDer. Ugyldige ID-er forårsaker feil.

Støttede elementer

Følgende er en liste over elementer som for øyeblikket støttes ved bruk av elementreferanse:

• Snarvei til et innsjøhus
• Funksjoner for brukerdata
• Notebook, gjennom NotebookUtils

Eksempel på Python-kode

Følgende kodeeksempel viser hvordan man bruker en itemreferanse i et python-skript.

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)

Denne koden gjør følgende:

• Løser en Item Reference-variabel fra et Fabric Variable-bibliotek
• Henter metadata-objektet for det refererte elementet
• Henter ut arbeidsområde-ID og vare-ID
• Skriver dem ut slik at de kan brukes programmessig.

Tillatelser som kreves for å opprette/bruke gjenstandsreferansevariabler

Bruk av elementreferansevariabler innebærer to lag med tillatelser:

• Opprett og rediger en elementreferansevariabel: Brukere med Bidragsyter eller høyere roller i arbeidsområdet kan opprette og redigere variabler i biblioteket, mens Viewers er skrivebeskyttet.
• Tilgang til elementreferansevariabelen: I tillegg til rettigheter på variabelbiblioteket, må du ha minst lesetillatelse på elementreferansevariabelen du har til hensikt å referere til.

For mer informasjon om tillatelser og tillatelsesvalidering, se Variable library permissions

Begrensninger

For øyeblikket kan du kun referere til tekstilartikler og semantiske modeller. Andre Power BI-elementer, som Datamarts og Dataflow Gen1, støttes for øyeblikket ikke.

Tilleggsinformasjon

Variabelbiblioteket muliggjør CI/CD for Fabric-innhold på tvers av miljøer (Dev, Test, Prod) ved bruk av Item Reference-variabler for nivåspesifikke konfigurasjoner. Vær oppmerksom på følgende:

• Gjenstandsreferanser er knyttet til et spesifikt arbeidsområde og gjenstands-ID.
• Når du distribuerer til et nytt stadium, peker disse referansene fortsatt til det opprinnelige arbeidsområdet med mindre de oppdateres manuelt.
• Bruk flere Value-Sets for hvert steg og aktiver riktig sett manuelt eller via API-skript.

For mer informasjon, se verdisett i variabelbiblioteker.

Relatert innhold

• Oversikt over variabelt bibliotek
• Variabeltyper
• Verdisett
• Variabelbibliotekstillatelser](./variable-library-permissions.md)