Zdieľať cez

Spustenie skenovania metaúdajov

  • Článok

V nasledujúcom krátkom návode sa dozviete, ako používať rozhrania API skenera na načítanie metaúdajov z položiek služby Fabric vašej organizácie. Predpokladá sa, že správca služby Fabric nastavil vo vašej organizácii skenovanie metaúdajov.

Zoznam artefaktov a metaúdajov podartifactu, ktoré vráti skenovanie metaúdajov, nájdete v dokumentácii pre rozhranie API Admin – WorkspaceInfo GetScanResult.

Nižšie sú uvedené rozhrania API skenera. Podporujú verejné aj suverénne cloudy.

Dôležité

Aplikácia, ktorú vytvoríte na skenovanie, sa môže overiť pomocou štandardného tokenu delegovaného správcu alebo objektu služby. Tieto dve cesty overovania sa navzájom vylučujú. Pri spúšťaní v objekte služby sa v aplikácii nesmú nastavovať žiadne povolenia vyžadujúce súhlas správcu služby Power BI. Ďalšie informácie nájdete v Povolenie overovania objektom služby pre rozhrania API správcu.

Krok č. 1: Vykonanie úplného skenovania

Ak chcete získať úplný zoznam ID pracovných priestorov v nájomníkovi, zavolajte pracovné priestory/upravené bez parametra modifiedSince . Tento test načíta všetky pracovné priestory v nájomníkovi vrátane osobných pracovných priestorov a zdieľaných pracovných priestorov. Ak chcete zo skenovania vylúčiť osobné pracovné priestory, použite parameter pracovné priestory/upravenévylúčte položky Osobné pracovné priestory.

Rozdeľte zoznam na bloky maximálne 100 pracovných priestorov.

Pre každý blok 100 pracovných priestorov:

Ak chcete spustiť volanie skenovania pre týchto 100 pracovných priestorov, zavolajte pracovné priestory alebo getInfo . V odpovedi dostanete scanId, ktorý použijete v ďalších krokoch. V hlavičke umiestnenia získate aj identifikátor URI (Uniform Resource Identifier), ktorý vás bude volať v ďalšom kroku.

Poznámka

Naraz je možné volať maximálne 16 volaní. Volajúci by mal počkať na úspešná alebo neúspešná odpoveď skenovania z rozhrania API scanStatus pred vyvolaním ďalšieho volania.

Ak sa nevrátia niektoré metaúdaje, ktoré by ste očakávali, obráťte sa na správcu služby Fabric, aby ste sa uistili, že povolil všetky relevantné prepínače správcu.

Použite identifikátor URI z hlavičky umiestnenia, ktorú ste získali od volania pracovných priestorov/súboru getInfo a ankety o pracovných priestoroch/scanStatus/{scan_id} , kým nebude vrátený stav "Úspešný". Tento stav znamená, že výsledok kontroly je pripravený. Odporúča sa použiť interval vzorkovania 30 – 60 sekúnd. V hlavičke umiestnenia dostanete aj identifikátor URI, ktorý vám zavoláte v ďalšom kroku. Použite ho až po tom, čo bude stav "Úspešné".

Použite identifikátor URI z hlavičky umiestnenia, ktorú ste dostali od volania pracovných priestorov/scanStatus/{scan-id} a prečítajte si údaje pomocou pracovných priestorov/scanResult/{scan_id}. Údaje obsahujú zoznam pracovných priestorov, informácie o položke a ďalšie metaúdaje na základe parametrov odovzdaných do pracovného priestoru alebo volania getInfo .

Krok 2: Vykonanie prírastkového skenovania

Teraz, keď máte všetky pracovné priestory a metaúdaje a pôvod ich položiek, odporúča sa vykonať len prírastkové kontroly, ktoré odkazujú na predchádzajúci sken, ktorý ste vykonali.

Zavolať pracovné priestory/upraviť pomocou parametra modifiedSince nastaveného na čas začiatku poslednej kontroly, aby sa získali pracovné priestory, ktoré sa zmenili, a ktoré preto vyžadujú ďalšie skenovanie. Parameter modifiedSince by mal byť nastavený pre dátum v priebehu posledných 30 dní.

Rozdeľte tento zoznam na bloky maximálne 100 pracovných priestorov a získajte údaje pre tieto zmenené pracovné priestory pomocou troch volaní rozhrania API, pracovných priestorov/getInfo, pracovných priestorov/scanStatus/{scan_id} a pracovných priestorov/scanResult/{scan_id}, ako je popísané v kroku 1.

Dôležité informácie a obmedzenia

  • sémantické modely, ktoré sa neobnovili alebo opätovne nepublikovali, sa vrátia v odpovediach rozhrania API, ale bez informácií a výrazov podartifactu. Napríklad sémantický názov modelu a pôvod sú zahrnuté v odpovedi, ale nie v názvoch tabuľky a stĺpcov sémantického modelu.
  • sémantické modely, ktoré obsahujú iba tabuľky DirectQuery , vrátia metaúdaje podartifactu iba v prípade, ak sa v sémantickom modeli vykonali určité akcie, napríklad ak nad ním niekto vytvára zostavu, niekto, kto si na ňom prezerá zostavu atď.
  • Množiny údajov v reálnom čase, sémantické modely so zabezpečením na úrovni objektu, sémantické modely s dynamickým pripojením k lokálnym službám AS-Azure a AS a množiny údajov s úplnou vernosťou Excelu nie sú pre metaúdaje podartifactu podporované. V prípade nepodporovaných množín údajov vráti odpoveď dôvod, prečo sa z množiny údajov nedostávali metaúdaje podartifactu. Nachádza sa v poli s názvom schemaRetrievalError, napríklad schemaRetrievalError: Nepodporovaná požiadavka. Množina údajov v reálnom čase nie je podporovaná.
  • Rozhranie API nevráti metaúdaje podartifactu pre sémantické modely, ktoré sú väčšie ako 1 GB v zdieľaných pracovných priestoroch. V pracovných priestoroch Premium neexistuje žiadne obmedzenie veľkosti pre sémantické modely.

Licencovanie

Skenovanie metaúdajov nevyžaduje žiadnu špeciálnu licenciu. Funguje pre všetky metaúdaje vášho nájomníka vrátane položiek, ktoré sa nachádzajú v pracovných priestoroch iných ako Premium.

Súvisiaci obsah