Spuštění kontroly metadat

  • Článek

Následující krátký návod ukazuje, jak pomocí rozhraní API skeneru načíst metadata z položek prostředků infrastruktury vaší organizace. Předpokládá se, že správce prostředků infrastruktury nastavil kontrolu metadat ve vaší organizaci.

Seznam metadat artefaktu a dílčích artefaktů, která vrací prohledávání metadat, najdete v dokumentaci k rozhraní API Správa – WorkspaceInfo GetScanResult.

Následuje rozhraní API skeneru. Podporují veřejné i suverénní cloudy.

Důležité

Aplikace, kterou vyvíjíte pro kontrolu, se může ověřit pomocí standardního delegovaného přístupového tokenu správce nebo instančního objektu. Obě cesty ověřování se vzájemně vylučují. Při spuštění pod instančním objektem nesmí být ve vaší aplikaci nastavená žádná oprávnění vyžadovaná správcem Power BI. Další informace najdete v tématu Povolení ověřování instančního objektu pro rozhraní API pro správu jen pro čtení.

Krok 1: Provedení úplné kontroly

Volejte pracovní prostory nebo upravte bez upraveného parametruSince, abyste získali úplný seznam ID pracovních prostorů v tenantovi. Tato kontrola načte všechny pracovní prostory v tenantovi, včetně osobních pracovních prostorů a sdílených pracovních prostorů. Pokud chcete z kontroly vyloučit osobní pracovní prostory, použijte parametr workspaces/modifiedexcludePersonalWorkspaces .

Rozdělte seznam na bloky maximálně 100 pracovních prostorů.

Pro každý blok 100 pracovních prostorů:

Voláním pracovních prostorů nebo getInfo aktivujete volání kontroly těchto 100 pracovních prostorů. V odpovědi, která se použije v dalších krocích, obdržíte id scanId. V hlavičce umístění obdržíte také identifikátor URI (Uniform Resource Identifier), který bude volat pro další krok.

Poznámka:

Současně není možné provádět více než 16 volání. Volající by měl před vyvoláním jiného volání počkat na úspěšnou nebo neúspěšnou odpověď z rozhraní SCANStatus API.

Pokud některá metadata, která jste očekávali, se nevrátí, obraťte se na správce prostředků infrastruktury a ujistěte se, že povolil všechny relevantní přepínače správce.

Použijte identifikátor URI z hlavičky umístění, kterou jste dostali z volajících pracovních prostorů/ getInfo a dotazování na pracovní prostory/scanStatus/{scan_id} , dokud se stav nevrátí jako úspěšný. Tento stav znamená, že výsledek kontroly je připravený. Doporučuje se použít interval dotazování 30 až 60 sekund. V záhlaví umístění obdržíte také identifikátor URI, který se má volat v dalším kroku. Použijte ho až po tom, co je stav Úspěch.

Použijte identifikátor URI z hlavičky umístění, kterou jste dostali z volajících pracovních prostorů/scanStatus/{scan-id} a načtěte data pomocí pracovních prostorů/scanResult/{scan_id}. Data obsahují seznam pracovních prostorů, informací o položkách a dalších metadat na základě parametrů předaných ve volání workspaces/getInfo .

Krok 2: Provedení přírůstkové kontroly

Teď, když máte všechny pracovní prostory a metadata a rodokmen jejich prostředků, doporučujeme provádět pouze přírůstkové kontroly, které odkazují na předchozí kontrolu, kterou jste provedli.

Volejte pracovní prostory nebo upravte pomocí parametru ModifiedSince nastaveným na počáteční čas poslední kontroly, abyste získali změněné pracovní prostory a které proto vyžadují další kontrolu. Parametr modifiedSince by měl být nastaven na datum během posledních 30 dnů.

Rozdělte tento seznam na bloky až 100 pracovních prostorů a získejte data těchto změněných pracovních prostorů pomocí tří volání rozhraní API, pracovních prostorů/getInfo, pracovních prostorů/scanStatus/{scan_id} a pracovních prostorů/scanResult/{scan_id}, jak je popsáno v kroku 1.

Úvahy a omezení

  • Sémantické modely, které nebyly aktualizovány nebo znovu publikovány, budou vráceny v odpovědích rozhraní API, ale bez jejich dílčích informací a výrazů. Do odpovědi jsou například zahrnuty sémantické názvy modelů a rodokmeny, ale ne názvy tabulek a sloupců sémantického modelu.
  • sémantické modely obsahující pouze tabulky DirectQuery vrátí subartifact metadata pouze v případě, že v sémantickém modelu byla provedena nějaká akce, například někdo, kdo sestavu sestavy vytváří nad ní, někdo, kdo na základě ní zobrazuje sestavu atd.
  • Datové sady v reálném čase, sémantické modely se zabezpečením na úrovni objektů, sémantickými modely s živým připojením k AS-Azure a MÍSTNÍMu prostředí AS a datové sady Excelu s plnou věrností nejsou podporovány pro dílčí metadata. U nepodporovaných datových sad vrátí odpověď důvod, proč z datové sady nezískala metadata podartifact. Nachází se v poli s názvem schemaRetrievalError, například schemaRetrievalError: Nepodporovaný požadavek. Datová sada RealTime se nepodporuje.
  • Rozhraní API nevrací subartifact metadata pro sémantické modely, které jsou ve sdílených pracovních prostorech větší než 1 GB. V pracovních prostorech Premium neexistuje žádné omezení velikosti sémantických modelů. [POTŘEBUJEME TENTO FAKTOR PRO PROSTŘEDKY INFRASTRUKTURY?]

Licencování

Kontrola metadat nevyžaduje žádnou speciální licenci. Funguje pro všechna metadata vašeho tenanta, včetně položek umístěných v pracovních prostorech mimo Premium.

Související obsah