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.

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.

Understøttede elementer

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

Notat

Notebook, through %%configure understøttes ikke.

Python-kodeeksempel

Følgende kodeeksempel viser, hvordan man bruger en itemreference i et python-script.

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 kode gør følgende:

  • Løser en Item Reference-variabel fra et Fabric-variabelbibliotek
  • Henter metadata-objektet for det refererede element
  • Udtrækker arbejdsområde-ID og vare-ID
  • Printer dem, så de kan bruges programmatisk.

Tilladelser kræves for at oprette/bruge referencevariabler for genstande

Brug af item reference-variabler involverer to lag af tilladelser:

  • Opret og rediger en elementreferencevariabel: Brugere med Bidragyder eller højere roller i arbejdsområdet kan oprette og redigere variabler i biblioteket, mens Viewers er skrivebeskyttede.
  • Adgang til elementreferencevariablen: Ud over rettigheder på Variable Library skal du have mindst læsetilladelse til den item reference variable , du har til hensigt at referere til.

For mere information om tilladelser og tilladelsesvalidering, se Variable bibliotekstilladelser

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.

Yderligere information

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:

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

Relateret indhold

  • Last updated on