Hoe maak je de afhankelijkheden tussen Power BI-rapportages en databronnen inzichtelijk?

Ed Kisman · 17 sep 2026

Power BI-omgevingen groeien snel. Wat begint als een handvol rapportages, wordt al gauw een complex netwerk van dashboards, datasets en databronnen die onderling van elkaar afhankelijk zijn. Zodra je een databron wilt aanpassen of een tabel hernoemt, wil je precies weten welke rapportages daardoor geraakt worden. Zonder dat overzicht loop je het risico dat rapporten onverwacht stukgaan of verouderde data tonen.

In dit stappenplan leer je hoe je de Power BI-afhankelijkheden tussen rapportages en databronnen volledig inzichtelijk maakt. Van een eerste verkenning in de beheerportal tot het opbouwen van een gestructureerd lineage-overzicht dat je actief kunt onderhouden. Na het doorlopen van deze stappen heb je een betrouwbare kaart van je Power BI-landschap die impactanalyses aanzienlijk sneller maakt.

Wat je nodig hebt vóór de analyse

Voordat je begint met het in kaart brengen van Power BI-databronnen en hun afhankelijkheden, is het belangrijk dat je de juiste toegangsrechten en hulpmiddelen bij de hand hebt. Zonder de juiste permissies kom je halverwege het proces vast te zitten.

Power BI Admin-rol of Fabric-beheerdersrol: je hebt beheerderstoegang nodig om de beheerportal en de Scanner API te kunnen gebruiken
Power BI REST API-toegang: zorg dat je een service principal of een account met API-rechten hebt ingesteld in Azure Active Directory
Power BI Desktop (optioneel): handig voor het inspecteren van individuele rapportages en hun modelrelaties
Een tool voor API-aanroepen: Postman, PowerShell of Python werken goed voor de Scanner API-stappen verderop
Een spreadsheet of visualisatietool: om de gevonden afhankelijkheden overzichtelijk vast te leggen, bijvoorbeeld in Excel, Visio of Power BI zelf

Controleer ook of de instelling “Allow service principals to use read-only Power BI admin APIs” is ingeschakeld in de tenantinstellingen van je Power BI-omgeving. Zonder deze instelling actief kun je de Scanner API niet aanroepen. Zodra je toegang en tooling op orde zijn, kun je beginnen met de eerste verkenning.

Gebruik de Power BI-beheerportal voor een eerste overzicht

De Power BI-beheerportal is het snelste startpunt voor een globaal overzicht van je omgeving. Navigeer naar app.powerbi.com, klik rechtsboven op het tandwielpictogram en kies Beheerportal. Hier vind je een overzicht van alle workspaces, datasets en rapporten binnen je tenant.

Ga naar Werkruimten in de beheerportal en exporteer de lijst naar CSV voor een startinventarisatie van alle actieve workspaces.
Open een specifieke workspace en bekijk welke datasets (semantische modellen) erin staan en aan welke rapporten ze gekoppeld zijn.
Klik op een dataset en controleer onder Lineage of de ingebouwde lineageweergave beschikbaar is. Power BI toont hier een visuele keten van databron naar dataset naar rapport.
Gebruik de filteropties om te zoeken op databrontype, zoals SQL Server, SharePoint of Azure Data Lake.

Na deze stap heb je een eerste indruk van de schaal van je omgeving en weet je welke workspaces de meeste afhankelijkheden bevatten. De ingebouwde lineageweergave is nuttig voor individuele datasets, maar schiet tekort zodra je een overzicht over meerdere workspaces tegelijk nodig hebt. Daarvoor gebruik je de Scanner API in de volgende stap.

Breng afhankelijkheden in kaart met de Scanner API

De Power BI-lineage op tenantniveau haal je op via de Scanner API, ook wel de Admin Workspace Info API genoemd. Deze API geeft gedetailleerde metadata terug over datasets, rapporten, dataflows en hun onderlinge verbindingen. Dit is de meest betrouwbare manier om een compleet afhankelijkheidsoverzicht te bouwen.

Stap 1: Workspaces ophalen

Roep eerst de lijst van alle workspaces op via de REST API-aanroep GET /v1.0/myorg/admin/workspaces/modified. Dit geeft je een lijst van workspace-ID’s die je in de volgende aanroep gebruikt.

Authenticeer je API-aanroep met een Bearer-token via Azure AD.
Roep het endpoint aan en sla de workspace-ID’s op in een variabele of bestand.
Gebruik POST /v1.0/myorg/admin/workspaces/getInfo met de workspace-ID’s als request body om een scan te starten.

Stap 2: Scanresultaten ophalen

De scan wordt asynchroon uitgevoerd. Gebruik het teruggegeven scanId om de status op te vragen via GET /v1.0/myorg/admin/workspaces/scanStatus/. Zodra de status Succeeded is, haal je de volledige resultaten op met GET /v1.0/myorg/admin/workspaces/scanResult/.

Verwerk de JSON-response en extraheer de velden datasets, reports, dataflows en datasourceInstances.
Koppel elk rapport aan zijn dataset via het veld datasetId.
Koppel elke dataset aan zijn databron via het veld datasourceUsages, dat verwijst naar de verbindingsstring en het type databron.
Leg de relaties vast in een platte tabel met kolommen: Databron, Dataset, Rapport, Workspace.

Na deze stap heb je een gestructureerde dataset met alle databronafhankelijkheden Power BI op tenantniveau. Controleer of alle workspaces zijn meegenomen in de scanresultaten. Ontbreken er workspaces, dan zijn die mogelijk ingesteld als persoonlijke workspaces of heb je onvoldoende rechten voor die specifieke omgeving.

Visualiseer de afhankelijkheidsketen in een overzicht

Ruwe data uit de Scanner API is waardevol, maar pas echt bruikbaar als je die omzet in een visueel overzicht. Een goede visualisatie maakt een Power BI-impactanalyse in één oogopslag mogelijk: je ziet direct welke rapporten worden geraakt als een databron wijzigt.

Laad de platte tabel die je in de vorige stap hebt gebouwd in Power BI Desktop of Excel.
Maak een netwerkdiagram of een geneste tabelstructuur met de hiërarchie: Databron > Dataset > Rapport > Workspace. In Power BI kun je hiervoor een maatwerkrapportage opbouwen met een matrix-visual of een decomposition tree.
Voeg filters toe op databrontype en workspace zodat je snel kunt inzoomen op een specifieke omgeving of systeem.
Markeer kritieke databronnen, bijvoorbeeld productiedatabases, met een kleurcode zodat ze direct opvallen in het overzicht.
Publiceer het overzicht naar een centrale workspace zodat zowel beheerders als rapportageontwikkelaars er toegang toe hebben.

Een goed samengesteld afhankelijkheidsoverzicht werkt als een levende kaart van je Power BI-rapportages. Je kunt er direct in zien hoeveel rapporten afhankelijk zijn van één dataset, of hoeveel datasets verbonden zijn met een specifieke SQL Server-instantie. Dat maakt het ook eenvoudiger om te bepalen waar BI-performanceoptimalisatie het meeste effect heeft.

Valideer en onderhoud het afhankelijkheidsoverzicht

Een afhankelijkheidsoverzicht dat één keer is gebouwd en daarna niet meer wordt bijgehouden, verliest snel zijn waarde. Power BI-omgevingen veranderen continu: nieuwe rapporten worden toegevoegd, databronnen worden aangepast en datasets worden samengevoegd. Zorg daarom voor een structureel validatie- en onderhoudsproces.

Plan een wekelijkse of maandelijkse automatische run van de Scanner API-aanroepen via een PowerShell-script of een Fabric-pipeline, zodat het overzicht altijd actueel is.
Vergelijk de nieuwe scanresultaten met de vorige versie en signaleer wijzigingen, zoals nieuwe afhankelijkheden of verdwenen datasets.
Stel alerts in voor kritieke databronnen: als een productiedatabase verdwijnt uit de scanresultaten, wil je dat direct weten.
Documenteer elk wijzigingsmoment met een tijdstempel en de naam van de verantwoordelijke beheerder, zodat je een audittrail hebt.
Bespreek het overzicht periodiek met rapportageontwikkelaars om te valideren of de gevonden afhankelijkheden nog kloppen met de werkelijkheid.

Naast geautomatiseerde controles is het verstandig om het overzicht ook handmatig te valideren na elke geplande wijziging in een databron of databaseschema. Controleer dan specifiek of alle rapporten die van die databron afhangen nog correct laden en actuele data tonen. Zo gebruik je het afhankelijkheidsoverzicht niet alleen reactief, maar ook als proactief instrument voor datagovernance en changemanagement binnen je organisatie.

Hoe DBA helpt met Power BI-afhankelijkheden inzichtelijk maken

Het volledig in kaart brengen van Power BI-afhankelijkheden vraagt om technische kennis van zowel de Power BI-omgeving als de onderliggende database-infrastructuur. Wij combineren die twee werelden en helpen organisaties om grip te krijgen op hun BI-landschap. Onze aanpak is concreet:

Inventarisatie en lineage-analyse: we brengen alle databronafhankelijkheden in kaart via de Scanner API en leveren een volledig overzicht van je Power BI-omgeving.
Maatwerk afhankelijkheidsdashboard: we bouwen een interactief Power BI-dashboard waarmee je zelf impactanalyses kunt uitvoeren bij wijzigingen in databronnen.
Koppeling met databasebeheer: als specialist in Oracle, SQL Server en PostgreSQL zien we direct welke databasewijzigingen impact hebben op je rapportages en adviseren we proactief.
Automatisering van het onderhoudsproces: we richten geautomatiseerde pipelines in zodat je afhankelijkheidsoverzicht altijd actueel blijft zonder handmatig werk.
24/7 ondersteuning: bij kritieke situaties, zoals een onverwachte databronwijziging die meerdere rapporten raakt, staan we klaar om snel te schakelen.

Wil je weten hoe we dit concreet voor jouw organisatie kunnen aanpakken? Neem contact met ons op en we denken graag met je mee.