Del via

Item reference variable type (forhåndsvisning)

For at øge fleksibiliteten og skalerbarheden introducerer vi avancerede variabler ved siden af de eksisterende grundlæggende variabeltyper. Disse avancerede variable er designet til at opfylde nøglekrav såsom parameterisering af eksterne og interne forbindelser (f.eks. Snowflake, AWS, OneLake).

En itemreferencevariabel er en avanceret variabeltype, der bruges i Fabric Variable Library til at holde en reference til et eksisterende Fabric-element – såsom et lakehouse, notesbog eller datapipeline – ved at gemme dets arbejdsområde-ID og item-ID. Denne type variabel muliggør intern forbindelsesparameterisering, så udviklere dynamisk kan linke elementer til specifikke Fabric-elementer baseret på implementeringsfase eller arbejdsområdekontekst.

Sådan bruges de

En itemreferencevariabel kan bruges ligesom andre variable i et variabelbibliotek.

  1. Log ind på Microsoft Fabric
  2. Navigér til dit arbejdsområde og variabelbibliotek
  3. Øverst vælger du + Ny variabel
  4. Angiv et navn til variablen, vælg item-reference for typen, og klik derefter på ... for at vælge en værdi
  5. Dette åbner en dialog for at vælge det ønskede element. Du vil se alle de elementer, du har tilladelser til, tilgængelige for valg. Brug stifinderen til venstre til at filtrere listen efter arbejdsområde. Brug filteret i øverste højre hjørne til at filtrere efter type.

Skærmbillede af de tilgængelige genstande til genstandsreference. 6. Når den er valgt, vil den fremstå sådan på varlib-siden – som en skrivebeskyttet komponent, der viser navnet på elementet.

Skærmbillede af genstandsreferencen.

Hvis du skal redigere en genstandsreference eller dobbelttjekke værdien:

  • For at se flere oplysninger klik på værdien
  • For at redigere denne værdi eller værdier af andre værdisæt – klik på knappen ved siden af værdien.

Skærmbillede af pop-up'en til genstandsreferencen.

Sådan fungerer det

En Item Reference-variabels værdi er i bund og grund en statisk peger til et Fabric-element identificeret ved Workspace ID + Item ID. Værdien gemmes som et par GUID'er, der svarer til målobjektets arbejdsområde og selve elementet. For eksempel kan en reference gemmes internt som:

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

Disse to ID'er identificerer tilsammen entydigt det refererede element.

Husk følgende, når du arbejder med genstandsreferencer:

  • Itemreferencer muliggør intern forbindelsesparameterisering, så udviklere dynamisk kan linke elementer til specifikke Fabric-ressourcer baseret på implementeringsstadie eller arbejdsområdekontekst.
  • Referencen er statisk, peger på et specifikt objekt og justerer sig ikke automatisk på tværs af miljøer.
  • For niveau-specifikke variationer bruges værdisæt, hvor hvert sæt kan pege på et forskelligt statisk element (f.eks. forskellige søhuse pr. trin).
  • Alle værdier på tværs af værdisæt bør være af samme item type for at sikre kompatibilitet og undgå runtime-fejl. Vi håndhæver dog ikke, at den samme varetype skal være på tværs af værdisæt.

Understøttede elementer

Følgende er en liste over elementer, der aktuelt understøttes ved hjælp af item reference:

Skærmbillede af genstandsreferencenotesbogen.

Notat

Notebook, through %%configure understøttes ikke.

Begrænsninger

I øjeblikket kan du kun referere til tekstilgenstande og semantiske modeller. Andre Power BI-elementer, som Datamarts og Dataflow Gen1, understøttes i øjeblikket ikke.

Tilladelser kræves for at oprette/bruge itemreferencer

Brug af Item Reference-variabler involverer to lag af tilladelser:

  • Oprette/Rediger - Selvom enhver workspace-bidragyder kan ændre variabelværdier, tillader en Item-referencevariabel kun, at brugere kan sætte værdigenstande, som de har læserettigheder til. Dette gælder for enhver værdi, det standard aktive værdisæt eller andre værdisæt. Vær opmærksom på, at der under gemning af et variabelt bibliotekselement udføres en tilladelsestjek på de aktive værdier af elementreferencevariabler for brugeren, der gemmer elementet, selvom disse værdier forbliver uændrede.
  • Brug en item ref-variabel - Når man opretter/opdaterer en reference til en variabel i en forbrugervare, kan brugere ikke sætte en reference til en item reference variable, medmindre de har mindst READ-tilladelse for varen i det aktive værdisæt.

Godkendelsesvalidering

Tilladelsesvalidering udløses i følgende brugstilfælde:

  • Rediger et variabelbibliotekselement, som har elementreferencevariabler Når vi redigerer, validerer vi både, at de refererede elementer eksisterer, og at brugeren mindst har læserettigheder til dem for alle elementreferenceværdier i det aktive værdisæt, for følgende scenarier:

  • UI - Under SAVE af variabelbibliotekselementet udføres en tilladelseskontrol på de aktive værdier af elementreferencevariabler for brugeren, der gemmer elementet, selvom disse værdier forbliver uændrede.

  • API'er/Git-opdatering - Tilladelsesvalidering udføres under opdateringen og fejler, hvis der ikke er læsetilladelse til Item ref'ens aktive værdi for det opdaterede arbejdsområde.

  • Udrulning - En variabel biblioteksobjekts udrulning vil fejle, hvis der ikke er læsetilladelse til objektreferens aktive værdi for målarbejdsområdet.

  • Se yderligere detaljer om objektreferencer på Variabelbibliotekssiden (kun UI) Brugere med adgang til Variabelbiblioteket (WS-viewer eller højere), som mangler tilladelser til elementet i den refererede elementvariabel, vil ikke se deres oplysninger i UI'en. I stedet vil de se vare-ID'et ledsaget af en hover-besked i stedet for detaljedelen.

Skærmbillede af tilladelserne.

  • Oprette/Rediger elementreferencevariabel

    • UI - Når man opdaterer værdien af et hvilket som helst værdisæt (standard eller andet), kan brugeren vælge elementer fra en liste, der kun viser elementer, han mindst har læsetilladelse til.
    • API'er/Git-opdatering eller udrulning - se Rediger variabelbibliotek ovenfor.

  • Brug af varereferencevariabel i en forbrugervare

    • UI - Oprettelse af en reference til variabel - Når man opretter en reference til en 'Item reference'-variabel i et element ved hjælp af 'Select variable' UI-dialogen (som i Shortcut for Lakehouse og Data pipeline), valideres brugeren, der opretter referencen, og har mindst læsetilladelse til elementerne i 'item reference'-variablerne (valideringen gælder kun for de aktive værdier). Hvis ikke, ser brugeren kun genstandenes ID.

Adfærd på tværs af CI/CD-pipelines og implementeringsfaser

Variabelbiblioteket muliggør CI/CD for Fabric-indhold på tværs af miljøer (Dev, Test, Prod) ved brug af Item Reference-variabler til stage-specifikke konfigurationer. Vær opmærksom på følgende:

Statiske referencer

  • Item References er knyttet til et specifikt arbejdsområde og item ID.
  • Når jeg udruler til et nyt stadie, peger disse referencer stadig på det oprindelige arbejdsområde, medmindre de opdateres manuelt.
  • Brug flere Value-Sets for hvert trin og aktiver det korrekte sæt manuelt eller via API-scripts.

For mere information, se værdisæt i variabelbiblioteker.

Repræsentation i Git og API'er

Variabelbiblioteket administreres som kode. Ved brug af Git- eller REST-API'er har Item Reference-variabler et klart JSON-format. Alle variabler vises i Variable Librarys definitionsfil (gemt i Git, normalt .json), hvor egenskaber som navn, type og værdi vises.

For en Item Reference (Statisk) variabel er værdien strukturerede data for arbejdsområde og vare-ID'er. 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 arbejder via API:

  • Kun ID'er gemmes; navne og metadata hentes ved kørsel eller caches i Fabric.
  • Når du opretter/opdaterer via API, leverer du arbejdsområde- og objekt-ID'er. Ugyldige ID'er forårsager fejl.

Relateret indhold

  • Last updated on