Delen via


Fabric-data-agent delen en machtigingsbeheer (voorlopige versie)

Belangrijk

Deze functie is beschikbaar als preview-versie.

Vereiste voorwaarden

Publiceren en versiebeheer

Het maken van een gegevensagent in Microsoft Fabric is een iteratief proces. Dit omvat verfijning van verschillende configuraties, bijvoorbeeld:

  • Relevante tabellen selecteren
  • Instructies voor Fabric-gegevensagent definiëren
  • Voorbeeldquery's maken voor elke gegevensbron

Wanneer u aanpassingen aanbrengt om de prestaties van de Fabric-gegevensagent te verbeteren, kunt u die Fabric-gegevensagent uiteindelijk publiceren. Zodra deze is gepubliceerd, wordt er een alleen-lezenversie gegenereerd, die u met anderen kunt delen.

Wanneer u de Fabric-gegevensagent probeert te publiceren, kunt u een beschrijving opnemen waarin wordt uitgelegd wat de Fabric-gegevensagent doet. De beschrijving is beschikbaar voor gebruikers van de Fabric-gegevensagent, zodat ze het doel en de functionaliteit ervan kunnen begrijpen. Andere geautomatiseerde systemen en orchestrators kunnen ook de beschrijving gebruiken om de Fabric-gegevensagent buiten Microsoft Fabric aan te roepen.

Notitie

U kunt de Fabric-gegevensagent vragen om te beschrijven wat deze doet. Vervolgens kunt u het antwoord verfijnen en samenvatten om het te gebruiken als beschrijving bij het publiceren.

Schermopname van het maken van een beschrijving van een Fabric-gegevensagent.

Nadat u de Fabric-gegevensagent hebt gepubliceerd, kunt u de huidige conceptversie verder verfijnen om de prestaties te verbeteren, zonder dat dit van invloed is op de gepubliceerde versie die anderen gebruiken. Op deze manier kunt u met vertrouwen herhalen, wetende dat uw wijzigingen geïsoleerd blijven van de gepubliceerde versie. U kunt naadloos schakelen tussen de gepubliceerde en conceptversies en dezelfde set query's op beide testen om hun prestaties te vergelijken. Dit helpt u bij het beoordelen van de effecten van uw wijzigingen en u kunt waardevolle inzichten krijgen in hoe ze de effectiviteit van uw Fabric-gegevensagent verbeteren. In de volgende schermopname ziet u hoe u kunt schakelen tussen gepubliceerde en ontwikkelde fabric-gegevensagentversies:

Schermopname waarin wordt getoond hoe u kunt schakelen tussen gepubliceerde en development Fabric-gegevensagentversies.

Als u de beschrijving van de Fabric-gegevensagent wilt bijwerken zonder andere wijzigingen aan te brengen, gaat u naar Instellingen, selecteert u Publicerenen werkt u de beschrijving bij, zoals wordt weergegeven in deze schermopname:

Schermopname waarin wordt getoond hoe u de beschrijving van de Fabric-gegevensagent bijwerkt.

Machtigingsmodellen voor delen en vereiste brontoegang

Met de functie Fabric-gegevensagent delen kunt u uw Fabric-gegevensagents delen met anderen, met een reeks machtigingsmodellen, zoals wordt weergegeven in deze schermopname.

schermopname van het delen van een Fabric-gegevensagentkoppeling.

U hebt volledige controle over de toegang tot uw Fabric-gegevensagent en volledige controle over het gebruik ervan. Daarnaast moet u, wanneer u de Fabric-gegevensagent deelt, ook de toegang delen tot de onderliggende gegevens die worden gebruikt. De Fabric-gegevensagent respecteert alle gebruikersmachtigingen voor de gegevens, waaronder Row-Level Security (RLS) en Column-Level Security (CLS).

Onderliggende machtigingen voor gegevensbronnen

Als een gebruiker een query kan uitvoeren via een Fabric-gegevensagent, hebben ze de minimale effectieve machtigingen nodig die hieronder worden weergegeven voor elk verbonden gegevensbrontype. Als ze minder dan de vermelde autorisatie hebben, lukken query's niet of retourneren ze lege resultaten.

Gegevensbrontype Minimale machtiging om query's uit te voeren via gegevensagent Opmerkingen
Semantisch Power BI-model Build (inclusief lezen) Alleen-lezen is niet voldoende omdat de agent modelquery's genereert waarvoor Build is vereist.
Lakehouse Lezen over het lakehouse-item (en tabeltoegang indien afgedwongen) Schrijven is niet nodig tenzij u gegevens wijzigt.
Magazijn Lezen (SELECT van relevante tabellen) Hogere machtigingen alleen voor DML-/DDL-bewerkingen.
KQL-databank Rol van lezer op de database Hogere rollen alleen voor beheeropdrachten.
Ontologie Lees over het ontologie-item en het onderliggende semantische model, de lakehouse of KQL-database die verbonden is met de ontologie.
Andere ondersteunde bronnen Toegang op zoekopdracht-/leesniveau Metagegevens en het ophalen van gegevens moeten zijn toegestaan.

Belangrijk

Als een gebruiker alleen leesmachtigingen heeft voor een semantisch model (geen build), kan de Fabric-gegevensagent de gegenereerde query's niet uitvoeren. Toestemming voor 'build' verlenen om interactieve queries mogelijk te maken.

Volg de minimale bevoegdheid: verwijs alleen de vereiste machtigingen voor de gegevensbron (voor semantische modellen betekent dit doorgaans bouwen zonder bredere werkruimterollen toe te wijzen, tenzij dat nodig is).

Als een gebruiker de Fabric-gegevensagent kan openen, maar geen minimale machtigingen heeft voor een of meer onderliggende bronnen, mislukken query's die deze bronnen aanraken met een autorisatiefout of retourneren lege resultaten, afhankelijk van het beveiligingsmodel van de bron.

  • Geen geselecteerde machtiging: als u geen andere machtiging selecteert, kunnen gebruikers alleen een query uitvoeren op de gepubliceerde versie van de Fabric-gegevensagent. Ze hebben geen toegang om configuraties of details te bewerken of zelfs weer te geven. Hiermee behoudt u de integriteit van de set-up van uw Fabric-gegevensagent.
  • Details weergeven: gebruikers kunnen de details en configuraties van zowel de gepubliceerde als de conceptversie van de Fabric-gegevensagent bekijken, maar ze kunnen er geen wijzigingen aan aanbrengen. Ze kunnen echter nog steeds query's uitvoeren op de Fabric-gegevensagent en informatieve inzichten bouwen zonder risico op onbedoelde wijzigingen.
  • Details bewerken en weergeven: gebruikers hebben volledige toegang om alle details en configuraties van zowel de gepubliceerde als de conceptversie van de Fabric-gegevensagent weer te geven en te bewerken. Ze kunnen ook een query uitvoeren op de Fabric-gegevensagent, waardoor het ideaal is voor samenwerking.

In de volgende schermopname ziet u de werkelijke machtigingen die u kunt selecteren:

Schermopname van de selectie van de daadwerkelijke machtigingen voor het delen van Fabric-gegevensagenten.

Als u een Fabric-gegevensagent deelt voordat u deze publiceert, kunnen gebruikers met standaardmachtigingen (zonder andere machtigingen) er geen query's op uitvoeren. Dit werkt op deze manier omdat gebruikers met de standaardmachtiging alleen een query kunnen uitvoeren op de gepubliceerde versie. Als er nog geen gepubliceerde versie bestaat, kunnen gebruikers geen query's uitvoeren op de Fabric-gegevensagent. Gebruikers met andere machtigingen (Details weergevenof Details bewerken en weergeven) hebben alleen toegang tot de conceptversie. In de volgende schermopname ziet u de optie om een Fabric-gegevensagent te delen zonder deze te publiceren:

Schermopname met de optie om een Fabric-gegevensagent te delen zonder te publiceren.