Jaa

Metatietojen skannaamisen suorittaminen

  • Artikkeli

Seuraavissa lyhyissä vaiheittaisissa ohjeissa näytetään, miten voit hakea metatietoja organisaatiosi Fabric-kohteista skannerin ohjelmointirajapintojen avulla. Tässä oletetaan, että Fabric-järjestelmänvalvoja on määrittänyt metatietojen skannauksen organisaatiossasi.

Luettelo metatietojen tarkistuksen palauttamista artefakteja ja aliartikkelin metatietoja on Admin – WorkspaceInfo GetScanResult -ohjelmointirajapinnan dokumentaatiossa.

Seuraavassa ovat skannerin ohjelmointirajapinnat. Ne tukevat sekä julkisia että maakohtaisia pilvipalveluita.

Tärkeä

Skannaamista varten kehittämäsi sovellus voi todentaa käyttämällä joko tavallista delegoidun järjestelmänvalvojan käyttöoikeustietuetta tai palvelun päänimeä. Kaksi todennuspolkua ovat toisensa poissulkevat. Kun suoritat palvelun päänimellä, sovelluksellesi ei saa määrittää Power BI:n järjestelmänvalvojan suostumusta vaatimia käyttöoikeuksia. Lisätietoja on artikkelissa Palvelun päänimen todentamisen ottaminen käyttöön vain luku -oikeutetuille järjestelmänvalvojan ohjelmointirajapinnoille.

Vaihe 1: Suorita täydellinen skannaus

Kutsu työtiloja/muokattu ilman modifiedSince-parametria , jotta saat täydellisen luettelon vuokraajan työtilatunnuksista. Tämä skannaus noutaa kaikki vuokraajan työtilat, mukaan lukien henkilökohtaiset työtilat ja jaetut työtilat. Jos haluat jättää henkilökohtaiset työtilat pois tarkistuksesta, käytä työtiloja/muokattuja poissulkejaPersonalWorkspaces-parametria .

Jaa luettelo enintään 100 työtilan lohkoihin.

Kullekin 100 työtilan lohkolle:

Kutsu työtiloja tai getInfo,niin näiden 100 työtilan skannauskutsu käynnistyy. Saat scanId-tunnuksen vastatessasi käytettäväksi seuraavissa vaiheissa. Sijainnin otsikossa saat myös Uniform Resource Identifier (URI) -kutsun seuraavaa vaihetta varten.

Muistiinpano

Samanaikaisesti voidaan tehdä enintään 16 kutsua. Soittajan tulisi odottaa scanStatus-ohjelmointirajapinnasta tarkistuksen onnistumista/epäonnistunutta vastausta, ennen kuin uusi kutsu käynnistyy.

Jos joitakin metatietoja, joita odotit saavasi, ei palauteta, varmista Fabric-järjestelmänvalvojalta, että ne ovat ottaneet käyttöön kaikki asianmukaiset järjestelmänvalvojan kytkimet.

Käytä URI-osoitetta sijaintiotsikosta, jonka sait työtilojen/getInfo-kutsun ja kyselystä työtiloissa/scanStatus/{scan_id}, kunnes palautettu tila on Onnistunut. Tämä tila tarkoittaa, että skannauksen tulos on valmis. On suositeltavaa käyttää kyselyväliksi 30–60 sekuntia. Sijaintiotsikossa saat myös URI-uri-oppaan, jota kutsutaan seuraavassa vaiheessa. Käytä sitä vasta, kun tila on Onnistui.

Käytä URI-osoitetta sijaintiotsikosta, jonka sait kutsumalla työtiloja/scanStatus/{scan-id} , ja lue tiedot käyttämällä työtiloja/scanResult/{scan_id}. Tiedot sisältävät luettelon työtiloista, kohteen tiedoista ja muista metatiedoista työtiloissa/getInfo-kutsussa välitettyjen parametrien perusteella.

Vaihe 2: Suorita lisäävä skannaus

Nyt kun sinulla on kaikki työtilat sekä niiden resurssien metatiedot ja historiatiedot, on suositeltavaa, että teet vain lisääviä skannauksia, jotka viittaavat edelliseen skannaukseen, jonka teit.

Kutsu työtiloja/muokattu, niin muokatunSince-parametrin arvoksi on asetettu viimeisimmän tarkistuksen alkamisaika, jotta saat muuttuneet työtilat, jotka edellyttävät uutta tarkistusta. ModifiedSince-parametri tulisi määrittää päivämääräksi viimeisten 30 päivän ajalta.

Jaa tämä luettelo enintään 100 työtilan lohkoihin ja nouda näiden muuttuneiden työtilojen tiedot käyttämällä kolmea ohjelmointirajapinnan kutsua, työtiloja/getInfoa, työtiloja/scanStatus/{scan_id}ja työtiloja/scanResult/{scan_id} vaiheessa 1 kuvatulla tavalla.

Huomioitavat asiat ja rajoitukset

  • Semanttiset mallit, joita ei ole päivitetty tai julkaistu uudelleen, palautetaan ohjelmointirajapintavastauksina, mutta ilman niiden aliartfiaktisia tietoja ja lausekkeita. Esimerkiksi semanttinen mallin nimi ja historiatiedot sisältyvät vastaukseen, mutta eivät semanttisen mallin taulukoiden ja sarakkeiden nimiin.
  • Vain DirectQuery-taulukoita sisältävät semanttiset mallit palauttavat aliartifact-metatiedot vain, jos semanttiseen malliin on ryhdytty jonkinlaisia toimia, kuten raportin laatija, raporttia sen perusteella tarkasteleva jne.
  • Reaaliaikaisia tietojoukkoja, semanttisia malleja, joissa on objektitason suojaus, semanttisia malleja, joilla on reaaliaikainen yhteys AS-Azureen ja AS:hen paikallisesti, ja Excelin täydellisiä uskollisuustietojoukkoja ei tueta subartifact-metatiedoilla. Jos tietojoukkoja ei tueta, vastaus palauttaa syyn sille, miksi aliartifact-metatietoja ei noutaa tietojoukosta. Se löytyy kentästä nimeltä schemaRetrievalError, esimerkiksi schemaRetrievalError: Ei tuettu pyyntö. Reaaliaikaista tietojoukkoa ei tueta.
  • Ohjelmointirajapinta ei palauta aliartfiaktisia metatietoja semanttisille malleille, jotka ovat jaettuissa työtiloissa yli 1 Gt. Premium-työtiloissa semanttisille malleille ei ole kokorajoitusta.

Käyttöoikeudet

Metatietojen skannaaminen ei edellytä erityistä käyttöoikeutta. Se toimii kaikkien vuokraajasi metatietojen kanssa, mukaan lukien muiden kuin Premium-työtilojen kohteiden metatiedot.

Liittyvä sisältö