Del via

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.

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

Skjermbilde av gjenstandsreferansen.

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.

Skjermbilde av gjenstandsreferanse-popupen.

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.

Støttede elementer

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

Skjermbilde av gjenstandsreferansenotatboken.

Note

Notebook, through %%configure støttes ikke.

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.

Tillatelser som kreves for å opprette/bruke objektreferanser

Bruk av Item Reference-variabler innebærer to lag med tillatelser:

  • Opprette/Rediger – Selv om enhver arbeidsområdebidragsyter kan endre variabelverdier, tillater en Item-referansevariabel kun brukere å sette som verdielementer de har lesetillatelser for. Dette gjelder for alle verdier, standard aktive verdisett eller andre verdisett. Vær oppmerksom på at når du lagrer et variabelbibliotek, utføres en tillatelsessjekk på de aktive verdiene til elementreferansevariablene for brukeren som lagrer elementet, selv om disse verdiene forblir uendret.
  • Bruk en item ref-variabel – Når man oppretter/oppdaterer en referanse til en variabel i en forbrukervare, kan brukere ikke sette en referanse til en itemreferansevariabel med mindre de har minst LESE-tillatelse for varen i det aktive verdisettet.

Validering av tillatelse

Tillatelsesvalidering utløses i følgende brukstilfeller:

  • Rediger et variabelbibliotek som har elementreferansevariabler Når vi redigerer, validerer vi både at de refererte elementene eksisterer, og at brukeren har minst lesetillatelser til dem, for alle elementreferanseverdier i det aktive verdisettet, for følgende scenarier:

  • UI - Under SAVE av variabelbiblioteket utføres en tillatelsessjekk på de aktive verdiene til elementreferansevariablene for brukeren som lagrer elementet, selv om disse verdiene forblir uendret.

  • API-er/Git-oppdatering – Tillatelsesvalidering utføres under oppdateringen og feiler hvis det ikke finnes lesetillatelse til Item refs aktive verdi for det oppdaterte arbeidsområdet.

  • Distribusjon – Distribusjonen av et variabelt bibliotekelement vil feile hvis det ikke er lesetillatelse til objektreferansens aktive verdi for målarbeidsområdet.

  • Se tilleggsdetaljer for gjenstandsreferanser på variabelbiblioteksiden (kun UI) Brukere med tilgang til variabelbiblioteket (WS-visning eller høyere) som mangler tillatelser for elementet i den refererte elementvariabelen, vil ikke se detaljene sine i UI. I stedet vil de se gjenstands-ID-en ledsaget av en hover-melding, i stedet for detaljkomponenten.

Skjermbilde av tillatelsene.

  • Opprette/Rediger elementreferansevariabel

    • UI – Når man oppdaterer verdi for et hvilket som helst verdisett (standard eller annet), kan brukeren velge et element fra en liste som kun viser elementer han i det minste har lesetillatelse til.
    • API-er/Git-oppdatering eller distribusjon – se Rediger variabelbibliotek ovenfor.

  • Bruk av gjenstandsreferansevariabel i en forbruksvarer

    • UI - Opprette en referanse til variabel - Når man oppretter en referanse til en 'Item reference'-variabel i et element ved å bruke UI-dialogen 'Select variable' (som i Shortcut for Lakehouse og Data pipeline), valideres det at brukeren som lager referansen i det minste har lesetillatelse til elementene i 'item reference'-variablene (valideringen gjelder kun de aktive verdiene). Hvis ikke, ser brukeren bare gjenstandenes ID.

Atferd på tvers av CI/CD-pipelines og distribusjonsstadier

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:

Statiske referanser

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

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.

Relatert innhold

  • Last updated on