Delen via

Metagegevens scannen uitvoeren

  • Artikel

In de volgende korte procedure ziet u hoe u de scanner-API's gebruikt om metagegevens op te halen uit de Fabric-items van uw organisatie. Hierbij wordt ervan uitgegaan dat een Fabric-beheerder metagegevensscans heeft ingesteld in uw organisatie.

Zie de documentatie voor de Api Admin - WorkspaceInfo GetScanResult voor de lijst met artefact- en subartifact-metagegevens die worden geretourneerd door het scannen van metagegevens.

Hier volgen de scanner-API's. Ze ondersteunen zowel openbare als onafhankelijke clouds.

Belangrijk

De app die u ontwikkelt voor scannen kan worden geverifieerd met behulp van een standaard gedelegeerd beheerderstoegangstoken of een service-principal. De twee verificatiepaden sluiten elkaar wederzijds uit. Wanneer u een service-principal uitvoert, mogen er geen machtigingen voor Power BI-beheerderstoestemming zijn ingesteld voor uw app. Zie Verificatie van de service-principal inschakelen voor alleen-lezen beheer-API's voor meer informatie.

Stap 1: Een volledige scan uitvoeren

Roep werkruimten aan/gewijzigd zonder de parameter modifiedSince om de volledige lijst met werkruimte-id's in de tenant op te halen. Met deze scan worden alle werkruimten in de tenant opgehaald, inclusief persoonlijke werkruimten en gedeelde werkruimten. Als u persoonlijke werkruimten wilt uitsluiten van de scan, gebruikt u de parameter workspaces/modified excludePersonalWorkspaces .

Deel de lijst maximaal in segmenten van 100 werkruimten.

Voor elk segment van 100 werkruimten:

Roep werkruimten/getInfo aan om een scanoproep voor deze 100 werkruimten te activeren. In de volgende stappen ontvangt u de scanId in het antwoord dat u wilt gebruiken. In de locatieheader ontvangt u ook de URI (Uniform Resource Identifier) om de volgende stap aan te roepen.

Notitie

Er kunnen niet meer dan 16 oproepen tegelijk worden gedaan. De aanroeper moet wachten op een scan geslaagd/mislukt antwoord van de scanStatus-API voordat een andere aanroep wordt aangeroepen.

Als sommige metagegevens die u verwacht te ontvangen niet worden geretourneerd, neemt u contact op met uw Fabric-beheerder om ervoor te zorgen dat alle relevante beheerswitches zijn ingeschakeld.

Gebruik de URI van de locatieheader die u hebt ontvangen van aanroepende werkruimten/getInfo en poll op werkruimten/scanStatus/{scan_id} totdat de geretourneerde status 'Succeeded' is. Deze status betekent dat het scanresultaat gereed is. Het is raadzaam om een polling-interval van 30-60 seconden te gebruiken. In de locatieheader ontvangt u ook de URI die u in de volgende stap wilt aanroepen. Gebruik deze pas nadat de status Geslaagd is.

Gebruik de URI van de locatieheader die u hebt ontvangen van het aanroepen van werkruimten/scanStatus/{scan-id} en lees de gegevens met behulp van werkruimten/scanResult/{scan_id}. De gegevens bevatten de lijst met werkruimten, itemgegevens en andere metagegevens op basis van de parameters die zijn doorgegeven in de aanroep werkruimten/getInfo .

Stap 2: Een incrementele scan uitvoeren

Nu u alle werkruimten en de metagegevens en herkomst van hun assets hebt, is het raadzaam om alleen incrementele scans uit te voeren die verwijzen naar de vorige scan die u hebt uitgevoerd.

Roep werkruimten aan/gewijzigd met de parameter modifiedSince ingesteld op de begintijd van de laatste scan om de werkruimten op te halen die zijn gewijzigd en die daarom een andere scan vereisen. De parameter modifiedSince moet worden ingesteld voor een datum binnen de afgelopen 30 dagen.

Deel deze lijst op in segmenten van maximaal 100 werkruimten en haal de gegevens voor deze gewijzigde werkruimten op met behulp van de drie API-aanroepen, werkruimten/getInfo, werkruimten/scanStatus/{scan_id} en werkruimten/scanResult/{scan_id}, zoals beschreven in stap 1.

Overwegingen en beperkingen

  • semantische modellen die niet zijn vernieuwd of opnieuw zijn gepubliceerd, worden geretourneerd in API-antwoorden, maar zonder hun subartifact-informatie en expressies. Semantische modelnaam en herkomst worden bijvoorbeeld opgenomen in het antwoord, maar niet in de tabel- en kolomnamen van het semantische model.
  • semantische modellen die alleen DirectQuery-tabellen bevatten, retourneren alleen subartifactmetagegevens als er een of andere actie is ondernomen op het semantische model, zoals iemand die er een rapport bovenop bouwt, iemand die een rapport bekijkt op basis van het rapport, enzovoort.
  • Realtime gegevenssets, semantische modellen met beveiliging op objectniveau, semantische modellen met een liveverbinding met AS-Azure en AS on-premises, en Excel-gegevenssets met volledige betrouwbaarheid worden niet ondersteund voor subartifact-metagegevens. Voor niet-ondersteunde gegevenssets retourneert het antwoord de reden voor het niet ophalen van de subartifact-metagegevens uit de gegevensset. Deze is te vinden in een veld met de naam schemaRetrievalError, bijvoorbeeld schemaRetrievalError: Niet-ondersteunde aanvraag. RealTime-gegevensset wordt niet ondersteund.
  • De API retourneert geen subartifact-metagegevens voor semantische modellen die groter zijn dan 1 GB in gedeelde werkruimten. In Premium-werkruimten is er geen groottebeperking voor semantische modellen.

Licenties

Scannen van metagegevens vereist geen speciale licentie. Het werkt voor alle metagegevens van uw tenant, inclusief die van items die zich in niet-Premium-werkruimten bevinden.

Gerelateerde inhoud