Del via

Kjør metadataskanning

  • Artikkel

Følgende korte gjennomgang viser hvordan du bruker skanner-API-ene til å hente metadata fra organisasjonens Fabric-elementer. Det forutsetter at en Fabric-administrator har konfigurert metadataskanning i organisasjonen.

Hvis du vil se listen over artefakt- og subartifact-metadata som metadataskanning returnerer, kan du se dokumentasjonen for API-en Admin – WorkspaceInfo GetScanResult.

Følgende er skanner-API-ene. De støtter både offentlige og suverene skyer.

Viktig

Appen du utvikler for skanning, kan godkjennes ved hjelp av enten et standard delegert tilgangstoken for administratorer eller en tjenestekontohaver. De to godkjenningsbanene er gjensidig utelukkende. Når du kjører under en tjenestekontohaver, må det ikke være angitt nødvendige tillatelser for Power BI-administratorsamtykke i appen. Hvis du vil ha mer informasjon, kan du se Aktivere godkjenning av tjenestekontohaver for skrivebeskyttede administrator-API-er.

Trinn 1: Utføre en fullstendig skanning

Kall arbeidsområder/endret uten den endredeSince-parameteren for å få den fullstendige listen over arbeidsområde-ID-er i leieren. Denne skanningen henter alle arbeidsområdene i leieren, inkludert personlige arbeidsområder og delte arbeidsområder. Hvis du vil utelate personlige arbeidsområder fra skanningen, kan du bruke parameteren excludePersonalWorkspaces for arbeidsområder.

Del listen i deler av 100 arbeidsområder på det meste.

For hver del av 100 arbeidsområder:

Ring arbeidsområder/getInfo for å utløse et skanneanrop for disse 100 arbeidsområdene. Du får scanId i svaret som skal brukes i de neste trinnene. I plasseringshodet vil du også motta Uniform Resource Identifier (URI) for å ringe etter neste trinn.

Merk

Ikke mer enn 16 anrop kan foretas samtidig. Anroperen bør vente på et vellykket/mislykket søk-svar fra scanStatus-API-en før du aktiverer et nytt anrop.

Hvis noen metadata du forventet å motta, ikke returneres, kan du ta kontakt med Fabric-administratoren for å sikre at de har aktivert alle relevante administratorbrytere.

Bruk URI-en fra plasseringshodet du mottok fra anrop av arbeidsområder/getInfo og undersøkelse på arbeidsområder/scanStatus/{scan_id} til statusen som returneres, er Vellykket. Denne statusen betyr at skanneresultatet er klart. Det anbefales å bruke et avstemningsintervall på 30–60 sekunder. I plasseringshodet mottar du også URI-en som skal ringe i neste trinn. Bruk den først etter at statusen er vellykket.

Bruk URI-en fra plasseringshodet du mottok fra kall til arbeidsområder/scanStatus/{scan-id} og les dataene ved hjelp av arbeidsområder/scanResult/{scan_id}. Dataene inneholder listen over arbeidsområder, elementinformasjon og andre metadata basert på parameterne som sendes i arbeidsområdene/getInfo-anropet .

Trinn 2: Utføre en trinnvis skanning

Nå som du har alle arbeidsområdene og metadataene og avstammingen til ressursene deres, anbefales det at du bare utfører trinnvise skanninger som refererer til den forrige skanningen du gjorde.

Kall arbeidsområder/endret med den endredeSince-parameteren satt til starttidspunktet for den siste skanningen for å få arbeidsområdene som er endret, og som derfor krever en ny skanning. ModifiedSince-parameteren må angis for en dato i løpet av de siste 30 dagene.

Del denne listen i deler på opptil 100 arbeidsområder, og hent dataene for disse endrede arbeidsområdene ved hjelp av de tre API-kall, arbeidsområder/getInfo, arbeidsområder/scanStatus/{scan_id}, og arbeidsområder/scanResult/{scan_id}, som beskrevet i trinn 1.

Hensyn og begrensninger

  • semantiske modeller som ikke har blitt oppdatert eller publisert på nytt, returneres i API-svar, men uten underartifact-informasjon og -uttrykk. Semantiske modellnavn og avstamming er for eksempel inkludert i svaret, men ikke tabell- og kolonnenavnene for den semantiske modellen.
  • semantiske modeller som bare inneholder DirectQuery-tabeller , returnerer subartifact-metadata bare hvis en slags handling har blitt utført på den semantiske modellen, for eksempel noen som bygger en rapport oppå den, noen som viser en rapport basert på den osv.
  • Sanntidsdatasett, semantiske modeller med sikkerhet på objektnivå, semantiske modeller med en live-tilkobling til AS-Azure og AS lokalt, og excel-datasett med fullstendig gjengivelse støttes ikke for subartifact-metadata. Når det gjelder datasett som ikke støttes, returnerer svaret årsaken til at du ikke får metadataene for delartifact fra datasettet. Den finnes i et felt kalt schemaRetrievalError, for eksempel schemaRetrievalError: Forespørsel som ikke støttes. RealTime-datasett støttes ikke.
  • API-en returnerer ikke subartifact-metadata for semantiske modeller som er større enn 1 GB i delte arbeidsområder. I Premium-arbeidsområder er det ingen størrelsesbegrensning på semantiske modeller.

Lisensiering

Metadataskanning krever ingen spesiell lisens. Det fungerer for alle metadataene til leieren, inkludert elementer som er plassert i arbeidsområder som ikke er Premium.

Relatert innhold