Metaadat-vizsgálat futtatása

  • Cikk

Az alábbi rövid útmutató bemutatja, hogyan használhatja a scanner API-kat a metaadatok lekérésére a szervezet Fabric-elemeiből. Feltételezi, hogy a Háló rendszergazdája metaadatok vizsgálatát állította be a szervezetben.

A metaadat-vizsgálat által visszaadott összetevő és subartifact metaadatok listájáért tekintse meg a Rendszergazda – WorkspaceInfo GetScanResult API dokumentációját.

A szkenner API-k a következők. Mind a nyilvános, mind a szuverén felhőket támogatják.

Fontos

A vizsgálathoz fejlesztett alkalmazás szabványos delegált rendszergazdai hozzáférési jogkivonat vagy szolgáltatásnév használatával hitelesíthető. A két hitelesítési útvonal kölcsönösen kizárja egymást. Szolgáltatásnév alatt való futtatáskor nem lehet power BI-rendszergazdai hozzájárulásra vonatkozó engedély beállítva az alkalmazásban. További információ: Egyszerű szolgáltatáshitelesítés engedélyezése írásvédett rendszergazdai API-khoz.

1. lépés: Teljes vizsgálat végrehajtása

A munkaterületek meghívása /módosítása a modifiedSince paraméter nélkül, hogy lekérje a munkaterület azonosítóinak teljes listáját a bérlőben. Ez a vizsgálat lekéri a bérlő összes munkaterületét, beleértve a személyes munkaterületeket és a megosztott munkaterületeket is. Ha ki szeretné zárni a személyes munkaterületeket a vizsgálatból, használja a munkaterületek/módosítottexcludePersonalWorkspaces paramétert .

A listát legfeljebb 100 munkaterület darabjaira osztja.

100 munkaterület minden egyes adattömbje esetén:

A munkaterületek/getInfo hívása a 100 munkaterület vizsgálathívásának elindításához. A következő lépésekben használni kívánt válaszban megkapja a scanId azonosítót. A hely fejlécében megjelenik az egységes erőforrás-azonosító (URI) is, amely meghívja a következő lépésre.

Feljegyzés

Egyszerre legfeljebb 16 hívás indítható. A hívónak meg kell várnia a scanStatus API sikeres/sikertelen válaszát, mielőtt újabb hívást kezdeményezne.

Ha a várt metaadatok egy része nem jelenik meg, forduljon a háló rendszergazdájához, és győződjön meg arról, hogy engedélyezték az összes releváns rendszergazdai kapcsolót.

Használja az URI-t a munkaterületek meghívása/getInfo hívása és a munkaterületek/scanStatus/{scan_id} lekérdezése által kapott helyfejlécből, amíg a visszaadott állapot "Sikeres". Ez az állapot azt jelenti, hogy a vizsgálati eredmény készen áll. Ajánlott 30–60 másodperces lekérdezési időközt használni. A hely fejlécében a következő lépésben a hívandó URI is megjelenik. Csak a "Sikeres" állapot után használja.

Használja a munkaterületek/scanStatus/{scan-id} hívásához kapott helyfejléc URI-ját, és olvassa be az adatokat a munkaterületek/scanResult/{scan_id} használatával. Az adatok a munkaterületek, elemadatok és egyéb metaadatok listáját tartalmazzák a munkaterületeken/getInfo-hívásban átadott paraméterek alapján.

2. lépés: Növekményes vizsgálat végrehajtása

Most, hogy már rendelkezik az összes munkaterületével, valamint az eszközeik metaadataival és ágával, javasoljuk, hogy csak növekményes vizsgálatokat végezzen, amelyek az előző vizsgálatra hivatkoznak.

Hívja meg a munkaterületeket/módosítsa a módosítottSince paramétert az utolsó vizsgálat kezdési időpontjára annak érdekében, hogy lekérje a módosított munkaterületeket, és ezért újabb vizsgálatot igényel. A modifiedSince paramétert az elmúlt 30 napon belüli dátumra kell beállítani.

Ossza fel a listát legfeljebb 100 munkaterületre, és kérje le a módosított munkaterületek adatait az 1. lépésben ismertetett három API-hívással, munkaterületekkel/getInfo-val, munkaterületekkel/scanStatus/{scan_id} és munkaterületekkel/scanResult/{scan_id}.

Szempontok és korlátozások

  • A nem frissített vagy ismételten közzétett szemantikai modellek API-válaszokban jelennek meg, de azok alartifact információi és kifejezései nélkül. Például a szemantikai modell neve és a vonalasság szerepel a válaszban, de a szemantikai modell táblázat- és oszlopneveit nem.
  • A csak DirectQuery-táblákat tartalmazó szemantikai modellek csak akkor adnak vissza subartifact metaadatokat, ha valamilyen műveletet hajtottak végre a szemantikai modellen, például ha valaki egy jelentést készít a tetején, valaki megtekint egy jelentést az alapján, stb.
  • A valós idejű adathalmazok, az objektumszintű biztonsággal rendelkező szemantikai modellek, az AS-Azure-hoz és a helyszíni AS-hez élő kapcsolattal rendelkező szemantikai modellek, valamint az Excel teljes hűségű adatkészletei nem támogatottak a metaadatok részartifaktikai használata esetén. Nem támogatott adathalmazok esetén a válasz azt az okot adja vissza, hogy nem kapják meg a subartifact metaadatokat az adathalmazból. Egy schemaRetrievalError nevű mezőben található, például schemaRetrievalError: Nem támogatott kérés. A RealTime-adatkészlet nem támogatott.
  • Az API nem ad vissza subartifact metaadatokat az 1 GB-nál nagyobb szemantikai modellekhez a megosztott munkaterületeken. Prémium szintű munkaterületeken nincs méretkorlátozás a szemantikai modellekre.

Licencek

A metaadatok vizsgálatához nincs szükség speciális licencre. A bérlő összes metaadataihoz használható, beleértve a nem prémium szintű munkaterületeken található elemeket is.

Kapcsolódó tartalom