Del via

Kør metadatascanning

  • Artikel

I følgende korte gennemgang kan du se, hvordan du bruger scanner-API'erne til at hente metadata fra organisationens Fabric-elementer. Det antages, at en Fabric-administrator har konfigureret metadatascanning i din organisation.

Du kan finde en liste over de metadata for artefakt og underartifik, som metadatascanning returnerer, i dokumentationen til API'en Admin – WorkspaceInfo GetScanResult.

Følgende er scanner-API'erne. De understøtter både offentlige og nationale cloudmiljøer.

Vigtigt

Den app, du udvikler til scanning, kan godkendes ved hjælp af enten et standarddelegeret administratoradgangstoken eller en tjenesteprincipal. De to godkendelsesstier udelukker hinanden gensidigt. Når du kører under en tjenesteprincipal, skal der ikke være angivet tilladelser for Power BI-administratorer, der kræver samtykke, på din app. Du kan få flere oplysninger under Aktivér godkendelse af tjenesteprincipal for skrivebeskyttede administrator-API'er.

Trin 1: Udfør en komplet scanning

Kald arbejdsområder/ændret uden parameteren modifiedSince for at få den komplette liste over arbejdsområde-id'er i lejeren. Denne scanning henter alle arbejdsområder i lejeren, herunder personlige arbejdsområder og delte arbejdsområder. Hvis du vil udelade personlige arbejdsområder fra scanningen, skal du bruge parameteren excludePersonalWorkspaces for arbejdsområder/ændret.

Opdel listen i dele af højst 100 arbejdsområder.

For hvert afsnit af 100 arbejdsområder:

Ring til arbejdsområder/getInfo for at udløse et scanningskald for disse 100 arbejdsområder. Du modtager scanId i svaret, der skal bruges i de næste trin. I placeringsheaderen modtager du også URI'en (Uniform Resource Identifier) for at kalde til næste trin.

Bemærk

Der kan ikke foretages mere end 16 opkald samtidigt. Kalderen skal vente på, at en scanning lykkes/mislykkedes fra scanStatus-API'en , før der aktiveres et andet kald.

Hvis nogle metadata, du forventede at modtage, ikke returneres, skal du kontakte fabric-administratoren for at sikre, at de har aktiveret alle relevante administratorparametre.

Brug URI'en fra den placeringsheader, du har modtaget fra kald af arbejdsområder/getInfo , og polling på arbejdsområder/scanStatus/{scan_id} , indtil den returnerede status er "Lykkedes". Denne status betyder, at scanningsresultatet er klar. Det anbefales at bruge et forespørgselsinterval på 30-60 sekunder. I placeringsheaderen modtager du også den URI, du skal kalde i næste trin. Brug den først, når status er "Lykkedes".

Brug URI'en fra den placeringsheader, du modtog fra at kalde arbejdsområder/scanStatus/{scan-id} , og læs dataene ved hjælp af arbejdsområder/scanResult/{scan_id}. Dataene indeholder en liste over arbejdsområder, elementoplysninger og andre metadata, der er baseret på de parametre, der overføres i opkaldet til arbejdsområder/getInfo .

Trin 2: Udfør en trinvis scanning

Nu, hvor du har alle arbejdsområder og metadataene og afstamningen af deres aktiver, anbefales det, at du kun udfører trinvise scanninger, der refererer til den forrige scanning, du udførte.

Kald arbejdsområder/ændret med parameteren modifiedSince angivet til starttidspunktet for den seneste scanning for at få de arbejdsområder, der er blevet ændret, og som derfor kræver en anden scanning. Parameteren modifiedSince skal angives for en dato inden for de seneste 30 dage.

Del denne liste op i segmenter på op til 100 arbejdsområder, og hent dataene for disse ændrede arbejdsområder ved hjælp af de tre API-kald, arbejdsområder/getInfo, arbejdsområder/scanStatus/{scan_id} og arbejdsområder/scanResult/{scan_id}, som beskrevet i trin 1.

Overvejelser og begrænsninger

  • semantiske modeller, der ikke er blevet opdateret eller publiceret igen, returneres i API-svar, men uden deres underartifaktoplysninger og udtryk. Semantisk modelnavn og afstamning er f.eks. inkluderet i svaret, men ikke i den semantiske models tabel- og kolonnenavne.
  • semantiske modeller, der kun indeholder DirectQuery-tabeller , returnerer kun underartifaktmetadata, hvis der er udført en form for handling på den semantiske model, f.eks. en person, der bygger en rapport oven på den, en person, der får vist en rapport baseret på den osv.
  • Datasæt i realtid, semantiske modeller med sikkerhed på objektniveau, semantiske modeller med en direkte forbindelse til AS-Azure og AS i det lokale miljø og Excel-datasæt med fuld pålidelighed understøttes ikke for underartifaktmetadata. For ikke-understøttede datasæt returnerer svaret årsagen til, at underartifaktmetadataene ikke blev hentet fra datasættet. Den findes i et felt med navnet schemaRetrievalError, f.eks. schemaRetrievalError: Anmodning, der ikke understøttes. RealTime-datasæt understøttes ikke.
  • API'en returnerer ikke underartifaktmetadata for semantiske modeller, der er større end 1 GB i delte arbejdsområder. I Premium-arbejdsområder er der ingen størrelsesbegrænsning på semantiske modeller.

Licenser

Scanning af metadata kræver ingen særlig licens. Det fungerer for alle din lejers metadata, herunder for elementer, der er placeret i ikke-Premium-arbejdsområder.

Relateret indhold