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.

Ondersteunde items

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

Schermopname van het notitieblok voor itemreferenties.

Opmerking

Notebook, via %%configure wordt niet ondersteund.

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.

Vereiste machtigingen voor het maken/gebruiken van itemverwijzingen

Het gebruik van itemreferentievariabelen omvat twee lagen machtigingen:

  • Maken/Bewerken - Hoewel elke bijdrager aan een werkruimte variabele waarden kan wijzigen, staat een verwijzingsvariabele van een item alleen gebruikers toe instellen als waarde items waarvoor ze leesrechten hebben. Dit geldt voor elke waarde, de standaardinstelling voor actieve waarden of andere waardesets. Houd er rekening mee dat tijdens het opslaan van een item variabelebibliotheek een machtigingscontrole wordt uitgevoerd op de actieve waarden van itemreferentievariabelen voor de gebruiker die het item opslaat, zelfs als deze waarden ongewijzigd blijven.
  • Een itemverwvariabele gebruiken : bij het maken/bijwerken van een verwijzing naar een variabele in een consumentenitem kunnen gebruikers geen verwijzing instellen naar een itemverwijzingsvariabele, tenzij ze ten minste leesmachtigingen hebben voor het item in de actieve waardeset.

Machtigingsvalidatie

Machtigingsvalidatie wordt geactiveerd in de volgende use-cases:

  • Bewerk een variabele bibliotheekitem met itemreferentievariabelen. Wanneer we deze bewerken, controleren we of de items waarnaar wordt verwezen bestaan, en of de gebruiker ten minste leesrechten heeft voor alle itemreferentiewaarden in de actieve waardeset voor de volgende scenario's:

  • Gebruikersinterface: tijdens HET OPSLAAN van het item Variabelebibliotheek wordt een machtigingscontrole uitgevoerd op de actieve waarden van itemverwijzingsvariabelen voor de gebruiker die het item opslaat, zelfs als deze waarden ongewijzigd blijven.

  • API's/Git Updates: machtigingsvalidatie wordt uitgevoerd tijdens het bijwerken en mislukt als er geen leesmachtiging is voor de actieve waarde van de itemverwijzing in de bijgewerkte werkruimte.

  • Implementatie: de implementatie van een variabel bibliotheekitem mislukt als er geen leesrechten zijn voor de actieve waarde van de itemreferentie van de doelwerkruimte.

  • Bekijk itemreferentie voor aanvullende details op de pagina Variabelebibliotheek (alleen UI) Gebruikers met toegang tot de Variabelebibliotheek (WS-viewer of hoger) die geen machtigingen hebben voor het item in de referentievariabele, zullen hun details niet zien in de UI. In plaats daarvan zien ze de item-id, vergezeld van een aanwijsbericht, in plaats van het detailonderdeel.

Schermopname van de machtigingen.

  • Verwijzingsvariabele voor item maken/bewerken

    • Gebruikersinterface: Wanneer de waarde van een willekeurige waardeset (standaard of andere) wordt bijgewerkt, kan de gebruiker een item selecteren in een lijst die alleen de items toont waarvoor hij ten minste leesrechten heeft.
    • API's/Git Update of Implementatie: zie Het item Variabele bibliotheek bewerken hierboven.

  • Gebruik van itemreferentievariabele in een consumentenitem

    • GEBRUIKERSINTERFACE - Een verwijzing naar een variabele maken: Bij het aanmaken van een verwijzing naar een 'Itemverwijzing'-variabele in een item met behulp van het dialoogvenster 'Variabele selecteren' (zoals in snelkoppelingen voor Lakehouse en de gegevenspijplijn), is er een validatie dat de gebruiker die de verwijzing maakt, minimaal leesmachtigingen heeft voor de items in de 'Itemverwijzing'-variabelen (de validatie geldt alleen voor de actieve waarden). Zo niet, dan ziet de gebruiker alleen de id van de items.

Gedrag tussen CI/CD-pijplijnen en implementatiefasen

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:

Statische verwijzingen

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

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.

Verwante inhoud

  • Last updated on