Delning och behörighetshantering för nätverksstruktursdataagent

Förutsättningar

• En betald F2- eller högre Fabric-kapacitet, eller en Power BI Premium-per-kapacitet (P1 eller högre) med Microsoft Fabric aktiverat.
• Klientinställningarna för infrastrukturdataagenten är aktiverade.
• Cross-geo-bearbetning för AI är aktiverad.
• Lagring mellan geografiska områden för AI är aktiverat.
• Minst en av dessa, med data: Ett lager, ett sjöhus, en eller flera Power BI-semantiska modeller, en KQL-databas eller en ontologi.
• Power BI-semantiska modeller via XMLA-slutpunktsklientväxeln är aktiverad för Power BI-semantiska modelldatakällor.

Publicering och versionshantering

Att skapa en dataagent i Microsoft Fabric är en iterativ process. Det omfattar förfining av olika konfigurationer, till exempel:

• Välja relevanta tabeller
• Definiera instruktioner för Fabric-dataagenten
• Skapa exempelfrågor för varje datakälla

När du gör justeringar för att förbättra prestandan för Fabric-dataagenten kan du så småningom publicera fabric-dataagenten. När den publiceras genereras en läsbar version som du kan dela med andra.

När du försöker publicera Fabric-dataagenten kan du ta med en beskrivning som förklarar vad Fabric-dataagenten gör. Beskrivningen är tillgänglig för användare av Fabric-dataagenten för att hjälpa dem att förstå dess syfte och funktioner. Andra automatiserade system och orkestrerare kan också använda beskrivningen för att anropa Fabric-dataagenten utanför Microsoft Fabric.

Anmärkning

Du kan be Fabric-dataagenten att beskriva vad den gör. Du kan sedan förfina och sammanfatta svaret som ska användas som beskrivning vid publicering.

När du har publicerat fabric-dataagenten kan du fortsätta att förfina den aktuella utkastversionen för att förbättra dess prestanda, utan att påverka den publicerade version som andra använder. På så sätt kan du iterera med tillförsikt och veta att dina ändringar förblir isolerade från den publicerade versionen. Du kan smidigt växla mellan de publicerade och utkastversionerna och testa samma uppsättning frågor på båda för att jämföra deras prestanda. Detta hjälper dig att utvärdera effekterna av dina ändringar och du kan få värdefulla insikter om hur de förbättrar effektiviteten för din Fabric-dataagent. Följande skärmbild visar hur du växlar mellan publicerade och utvecklade fabric-dataagentversioner:

Om du vill uppdatera beskrivningen av fabric-dataagenten utan att göra några andra ändringar går du till Inställningar, väljer Publicering och uppdaterar sedan beskrivningen, som visas i den här skärmbilden:

Dela behörighetsmodeller och nödvändig källåtkomst

Med delning av Fabric-dataagenter kan du dela dina Fabric-dataagenter med andra, med en rad olika behörighetsmodeller, som visas i skärmbilden:

Du har fullständig kontroll över åtkomsten till din Fabric-dataagent och fullständig kontroll över dess användning. När du delar dataagenten Fabric måste du dessutom dela åtkomst till de underliggande data som används. Fabric-dataagenten respekterar alla användarbehörigheter för data, inklusive Row-Level Security (RLS) och Column-Level Security (CLS).

Behörigheter för underliggande datakälla

För att en användare ska kunna fråga via en Fabric-dataagent behöver de de minsta effektiva behörigheter som visas nedan för varje ansluten datakällatyp. Om de har mindre än den angivna behörigheten misslyckas frågor eller returnerar tomma resultat.

Typ av datakälla	Minsta behörighet att fråga via dataagent	Noteringar
Power BI-semantisk modell	Bygg (inkluderar Läs)	Det räcker inte att läsa ensam eftersom agenten genererar modellfrågor som kräver Build.
Lakehouse	Läs från lakehouse-databasen (och tabellåtkomst om det krävs)	Skrivning krävs endast vid ändring av data.
Lager	Läs (SELECT i relevanta tabeller)	Högre behörigheter endast för DML/DDL-åtgärder.
KQL-databas	Läsarroll i databasen	Högre roller endast för hanteringskommandon.
Ontologi	Läs om ontologiobjektet och Läs om den underliggande semantiska modellen, lakehouse- eller KQL-databasen som är bunden till ontologin
Andra källor som stöds	Åtkomst på fråge-/läsåtkomstnivå	Måste tillåta metadata och dataåtervinning.

Viktigt!

Om en användare bara har läsbehörighet för en semantisk modell (ingen Bygg), kan Fabric-dataagenten inte köra sina genererade frågor. Bevilja Build för att aktivera interaktiv frågekörning.

Följ lägsta behörighet: bevilja endast de datakällbehörigheter som krävs (för semantiska modeller innebär detta vanligtvis Skapa utan att tilldela bredare arbetsyteroller om det inte behövs).

Om en användare kan öppna fabric-dataagenten men saknar minsta behörighet för en eller flera underliggande källor misslyckas frågor som rör dessa källor med ett auktoriseringsfel eller returnerar tomma resultat, beroende på källans säkerhetsmodell.

• Ingen behörighet har valts: Om du inte väljer någon annan behörighet kan användarna bara köra frågor mot den publicerade versionen av Fabric-dataagenten. De har ingen åtkomst till att redigera eller ens visa några konfigurationer eller information. Detta upprätthåller integriteten för installationen av Fabric-dataagenten.
• Visa information: Användarna kan visa information och konfigurationer för både publicerade och utkastversioner av Fabric-dataagenten, men de kan inte göra några ändringar i den. De kan dock fortfarande fråga Fabric-dataagenten och skapa informativa insikter utan risk för oavsiktliga ändringar.
• Redigera och visa information: Användare har fullständig åtkomst till att visa och redigera all information och alla konfigurationer för både publicerade och utkastversioner av Fabric-dataagenten. De kan också fråga dataagenten Fabric, vilket gör den idealisk för samarbete.

Följande skärmbild visar de faktiska behörigheter som du kan välja:

Om du delar en Fabric-dataagent innan du publicerar den kan användare med standardbehörigheter (utan andra behörigheter) inte köra frågor mot den. Det fungerar på det här sättet eftersom standardbehörigheten tillåter användare att endast köra frågor mot den publicerade versionen– om det ännu inte finns någon publicerad version kan användarna inte fråga fabric-dataagenten. Användare med andra behörigheter (Visa information eller Redigera och visa information) kan bara komma åt utkastversionen. Följande skärmbild visar alternativet att dela en Fabric-dataagent utan att publicera den:

Relaterat innehåll

• Koncept för dataagent
• Inställningar för Fabric-dataagentens klientorganisation
• Skapa en Fabric-dataagent