Delen via

Itemverwijzingsvariabele type (preview)

Om de flexibiliteit en schaalbaarheid te verbeteren, introduceren we geavanceerde variabelen naast de bestaande basisvariabeletypen. Deze geavanceerde variabelen zijn ontworpen om te voldoen aan belangrijke vereisten, zoals het parameteriseren van externe en interne verbindingen (bijvoorbeeld Snowflake, AWS, OneLake).

Een itemreferentievariabele is een geavanceerd variabeletype dat in de Fabric-variabelebibliotheek wordt gebruikt om een verwijzing naar een bestaand Fabric-item, zoals een lakehouse, notebook of gegevenspijplijn, te bewaren door de werkruimte-id en item-id op te slaan. Met dit type variabele kunnen interne verbindingsparameterisaties worden ingeschakeld, zodat ontwikkelaars items dynamisch kunnen koppelen aan specifieke Fabric-items op basis van de implementatiefase of werkruimtecontext.

Gebruiksinstructies

Een itemreferentievariabele kan net als andere variabelen in een variabelebibliotheek worden gebruikt.

  1. Aanmelden bij Microsoft Fabric
  2. Navigeer naar uw werkruimte en variabele bibliotheek
  3. Selecteer bovenaan + Nieuwe variabele
  4. Geef een naam op voor de variabele, selecteer itemreferentie voor het type en klik vervolgens op de ... om een waarde te selecteren
  5. Hiermee opent u een dialoogvenster om het gewenste item te selecteren. U ziet alle items waarvoor u machtigingen hebt, die beschikbaar zijn voor selectie. Gebruik de verkenner aan de linkerkant om de lijst te filteren op werkruimte. Gebruik het filter in de rechterbovenhoek om te filteren op type.

Schermopname van de items die beschikbaar zijn voor de itemreferentie. 6. Zodra deze is geselecteerd, wordt deze weergegeven op de varlib-pagina, als een alleen-lezen onderdeel met de naam van het item.

Schermopname van de itemreferentie.

Als u een itemverwijzing wilt bewerken of de waarde wilt controleren:

  • klik op de waarde om aanvullende details weer te geven
  • als u deze waarde of waarden van andere waardesets wilt bewerken, klikt u op de knop naast de waarde.

Schermopname van het pop-upvenster voor itemverwijzing.

Hoe het werkt

De waarde van een variabele Itemreferentie is in wezen een statische aanwijzer naar een Fabric-item dat wordt geïdentificeerd door werkruimte-id + item-id. De waarde wordt opgeslagen als een paar GUID's die overeenkomen met de werkruimte van het doelitem en het item zelf. Een verwijzing kan bijvoorbeeld intern worden opgeslagen als:

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

Deze twee id's identificeren het item waarnaar wordt verwezen, uniek.

Houd rekening met het volgende bij het werken met itemverwijzingen:

  • Itemverwijzingen maken interne verbindingsparameterisatie mogelijk, zodat ontwikkelaars items dynamisch kunnen koppelen aan specifieke Fabric-resources op basis van de implementatiefase of werkruimtecontext.
  • De verwijzing is statisch, wijst naar een specifiek item en past niet automatisch aan in verschillende omgevingen.
  • Voor fasespecifieke variaties gebruikt u waardesets, waarbij elke set kan verwijzen naar een ander statisch item (bijvoorbeeld verschillende lakehouses per fase).
  • Alle waarden in waardesets moeten van hetzelfde itemtype zijn om compatibiliteit te garanderen en runtimefouten te voorkomen. We dwingen echter niet af dat hetzelfde itemtype voor waardesets wordt gebruikt.

Weergave in Git en API’s

De variabelebibliotheek wordt beheerd als code. Met Git- of REST-API's hebben itemreferentievariabelen een duidelijke JSON-indeling. Alle variabelen worden weergegeven in het definitiebestand van de variabelebibliotheek (opgeslagen in Git, meestal .json), met eigenschappen zoals naam, type en waarde.

Voor een Item Reference (statische) variabele zijn de waarden gestructureerde gegevens met betrekking tot werkruimte- en item-id's. Voorbeeld:


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

Onthoud het volgende wanneer u werkt via API:

  • Alleen id's worden opgeslagen; namen en metagegevens worden opgehaald tijdens runtime of in de cache opgeslagen in Fabric.
  • U kunt werkruimte- en item-ID's maken/bijwerken via de API. Ongeldige id's veroorzaken fouten.

Ondersteunde items

Hier volgt een lijst met items die momenteel worden ondersteund met behulp van itemreferenties:

Opmerking

Notebook, via %%configure wordt niet ondersteund.

Voorbeeld van Python-code

In het volgende codevoorbeeld ziet u hoe u een itemreferentie gebruikt in een 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)

Deze code doet het volgende:

  • Lost een itemreferentievariabele op uit een fabric-variabelebibliotheek
  • Hiermee wordt het metagegevensobject opgehaald voor dat item waarnaar wordt verwezen
  • Extraheert de werkruimte-id en item-id
  • Hiermee drukt u ze af zodat ze programmatisch kunnen worden gebruikt.

Vereiste machtigingen voor het maken/gebruiken van itemreferentievariabelen

Het gebruik van itemreferentievariabelen omvat twee lagen machtigingen:

  • Een itemverwijzingsvariabele maken en bewerken: Gebruikers met de rollen Bijdrager of hogere rollen in de werkruimte kunnen variabelen maken en bewerken in de bibliotheek, terwijl kijkers alleen leesrechten hebben.
  • Toegang tot de itemverwijzingsvariabele: naast rechten voor de variabelebibliotheek moet u ten minste leesmachtigingen hebben voor de itemverwijzingsvariabele waarnaar u wilt verwijzen.

Voor meer informatie over machtigingen en machtigingsvalidatie, zie machtigingen van de variabelenbibliotheek.

Beperkingen

Op dit moment kunt u alleen verwijzen naar fabric-items en semantische modellen. Andere Power BI-items, zoals Datamarts, Dataflow Gen1 worden momenteel niet ondersteund.

Aanvullende informatie

De variabelebibliotheek maakt CI/CD voor Fabric-inhoud mogelijk in verschillende omgevingen (Dev, Test, Prod) met behulp van itemverwijzingsvariabelen voor fasespecifieke configuraties. Houd rekening met het volgende:

  • Itemverwijzingen zijn gekoppeld aan een specifieke werkruimte en item-id.
  • Als u in een nieuwe fase implementeert, verwijzen deze verwijzingen nog steeds naar de oorspronkelijke werkruimte, tenzij deze handmatig zijn bijgewerkt.
  • Gebruik meerdere Value-Sets voor elke fase en activeer de juiste set handmatig of via API-scripts.

Zie waardesets in variabelenbibliotheken voor meer informatie.

Verwante inhoud

  • Last updated on