Datový model pro analýzu

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Datový model Analytics pro Azure DevOps se skládá ze sad entit, jejichž členové (entity) obsahují vlastnosti, které je možné filtrovat, agregovat a sumarizovat. Kromě toho obsahují navigační vlastnosti , které souvisejí s entitami, a poskytují přístup k dalším vlastnostem pro výběr, filtrování a seskupení.

Poznámka:

Služba Analytics je automaticky povolená a podporovaná v produkčním prostředí pro všechny služby Azure DevOps Services. Integrace Power BI a přístup k datovému kanálu OData služby Analytics jsou obecně dostupné. Doporučujeme, abyste ho používali a poskytli nám zpětnou vazbu. Dostupná data jsou závislá na verzi. Nejnovější podporovaná verze je v2.0a nejnovější verze Preview je v4.0-preview. Další informace najdete v tématu Správa verzí rozhraní API OData.

Obory názvů schématu

Datový model Analýza je založený na dvou oborech názvů schématu:

• Microsoft.VisualStudio.Services.Analytics.Model
• Microsoft.VisualStudio.Services.Analytics.

Sady entit a typy entit

Typy entit jsou pojmenované strukturované typy s klíčem. Definují pojmenované vlastnosti a vztahy každé entity. Klíč objektu je EntityType vytvořen z podmnožina primitivních vlastností, například WorkItemId, PipelineId, ReleasePipelineId a dalších typů entit.

Sady entit jsou pojmenované kolekce entit. Jedná se například WorkItems o sadu entit obsahující WorkItem entity. Klíč entity jednoznačně identifikuje entitu v rámci sady entit. Pokud používá více sad entit stejný typ entity, může se stejná kombinace hodnot klíčů zobrazit ve více než jedné sadě entit a identifikovat různé entity, jednu na sadu entit, ve které se tato kombinace kláves zobrazuje. Každá z těchto entit má jiné ID entity. Sady entit poskytují vstupní body do datového modelu.

Sady entit jsou popsány v metadatech OData a liší se podle projektu. Úplný seznam sad entit, typů entit a vlastností můžete prozkoumat vyžádáním metadat OData pro váš projekt. Postup najdete v tématu Vytváření dotazů OData pro analýzu.

Složené entity

Složené entity podporují konkrétní scénáře. Skládají se z jednodušších entit, často vyžadují k vygenerování více výpočetních prostředků a můžou vracet větší sady výsledků. Abyste dosáhli nejlepšího výkonu a vyhnuli se zbytečnému omezování, ujistěte se, že se ve svém scénáři dotazujete na správnou entitu.

Například WorkItemSnapshot kombinuje WorkItemRevisions a Dates tak, aby každé datum má pro každou pracovní položku jednu revizi. Tato reprezentace podporuje dotazy OData, které se zaměřují na data trendu pro filtrovanou sadu pracovních položek. Tuto složenou entitu byste ale neměli používat k dotazování aktuálního stavu pracovních položek. Místo toho byste měli použít WorkItems sadu entit k vygenerování rychlejšího dotazu.

Podobně mohou některé entity obsahovat všechny historické hodnoty, zatímco jiné můžou obsahovat pouze aktuální hodnoty. WorkItemRevisions obsahuje všechny historie pracovních položek, které byste neměli používat ve scénářích, kde jsou aktuální hodnoty zajímavé.

Relace

Pokud chcete vygenerovat složitější výsledky dotazů, můžete kombinovat entity pomocí relací. Relace můžete použít k rozbalení, filtrování nebo sumarizaci dat.

Některé vlastnosti navigace vedou k jedné entitě, zatímco jiné mají za následek kolekci entit. Následující diagram znázorňuje vybrané entity a jejich navigační vlastnosti. Pro přehlednost byly vynechány některé složené entity a relace.

Klíče relací

Relace entit jsou také reprezentovány jako cizí klíče, aby externí nástroje mohly spojit entity. Tyto vlastnosti mají příponu SK a jsou buď celé číslo, nebo datové typy GUID. Vlastnosti data mají odpovídající celočíselné vlastnosti klíče kalendářního data s následujícím formátem: RRRRMMDD.

Typy entit a sady entit sledování práce

Následující typy entit a sady entit jsou podporovány v uvedených verzích rozhraní API. Kompletní referenční informace najdete v tématu Referenční informace o metadatech sledování práce pro Azure Boards Analytics.

EntityType/EntitySet	Popis	v1.0	v2.0	v3.0-preview	v4.0-preview
Plocha/ Oblasti	Cesty oblasti pracovní položky s vlastnostmi pro seskupení a filtrování podle hierarchie oblastí.	✔️	✔️	✔️	✔️
Iterace/ Iterace	Cesty iterace pracovní položky s vlastnostmi pro seskupení a filtrování podle hierarchie iterací.	✔️	✔️	✔️	✔️
BoardLocation/ BoardLocations	Umístění buněk panelu, jak je identifikováno sloupcem desky, plaveckou drahou a rozdělením, zahrnuje nastavení historické desky. Popis jednotlivých polí panelu najdete v tématu Pracovní postup a pole panelu.	✔️	✔️	✔️	✔️
CalendarDate/ Datle	Data použitá k filtrování a seskupení dalších entit pomocí relací.	✔️	✔️	✔️	✔️
Projekt/ Projekty	Všechny projekty definované pro organizaci (cloud) nebo kolekci projektů (místní).	✔️	✔️	✔️	✔️
Proces/ Procesy	Informace o backlogu používané k rozbalení nebo filtrování pracovních položek a typů pracovních položek Příklad, který používá procesy k filtrování sestavy, naleznete v části Požadavky sledování ukázkové sestavy.		✔️	✔️	✔️
Tag/ Značky	Všechny značky pracovních položek pro každý projekt Příklad, který k filtrování sestavy používá značky , najdete v ukázkové sestavě burndownu vydané verze.	✔️	✔️	✔️	✔️
Team/ Teams	Všechny týmy definované pro projekt. Příklad, který používá Teams k filtrování sestavy, najdete v tématu Přidání průřezu týmu do sestavy Power BI.	✔️	✔️	✔️	✔️
Uživatel/ Uživatelé	Informace o uživateli, které slouží k rozbalení nebo filtrování různých vlastností pracovní položky, například Přiřazeno, Vytvořeno uživatelem.	✔️	✔️	✔️	✔️
WorkItemBoardSnapshot/ WorkItemBoardSnapshot	(složené) Stav každé pracovní položky pro každé datum kalendáře, včetně umístění panelu, sloužící ke generování sestav trendů. Ukázkovou sestavu najdete v ukázkové sestavě diagramu toku (CFD).	✔️	✔️	✔️	✔️
WorkItemLink/ WorkItemLinks	Vazby mezi pracovními položkami, například podřízené položky, nadřazené položky a související. Obsahuje pouze nejnovější revizi odkazů, bez historie. Hypertextové odkazy nejsou zahrnuty.	✔️	✔️	✔️	✔️
WorkItemRevision/ WorkItemRevisions	Všechny revize historických pracovních položek, včetně aktuální revize. Nezahrnuje odstraněné pracovní položky.	✔️	✔️	✔️	✔️
WorkItemSnapshot/ WorkItemSnapshot	(složené) Stav každé pracovní položky v každém kalendářním datu, který slouží k podpoře generování sestav trendů. Ukázkovou sestavu najdete v ukázkové sestavě trendů chyb.	✔️	✔️	✔️	✔️
WorkItem/ Pracovní položky	Aktuální stav pracovních položek. Používá se k podpoře zpráv o stavu. Ukázkovou sestavu najdete v tématu Souhrn hodnot podřízených pracovních položek do nadřazené ukázkové sestavy.	✔️	✔️	✔️	✔️
WorkItemTypeField/ WorkItemTypeFields	Vlastnosti pracovní položky pro každý typ a proces pracovní položky. Používá se k podpoře vytváření sestav.	✔️	✔️	✔️	✔️

Typy entit a sady entit pipelines

Následující typy entit a sady entit jsou podporovány ve verzi v3.0-Preview nebo v4.0-preview Analytics. Úplný odkaz naleznete v tématu Odkaz na metadata kanálu .

EntityType/EntitySet	Popis	v3.0-preview	v4.0-preview
Větev/ Větve	Základní informace o větvích používaných v testech nebo kanálech Ukázkovou sestavu najdete v ukázkové sestavě stavu průběhu.	✔️	✔️
ParallelPipelineJobsSnapshot/ ParallelPipelineJobsSnapshot	(složené) Podporuje pochopení spotřeby paralelních kanálů. Další informace o paralelních testech kanálu naleznete v tématu Paralelní spouštění testů pomocí úlohy Visual Studio Test.		✔️
Potrubí/ Pipelines	Vlastnosti kanálu	✔️	✔️
PipelineJob/ PipelineJobs	Výsledky jednotlivých spuštění pro konkrétní test přidružený k testovacímu spuštění	✔️	✔️
PipelineRun/ PipelineRuns	Informace o spuštění pro kanály Ukázkovou sestavu najdete v části Ukázková sestava trendu rychlosti kanálu.	✔️	✔️
PipelineRunActivityResult/ PipelineRunActivityResults	Sloučený protokol všech fází, kroků, úloh a úkolů v rámci konkrétního spuštění kanálu. Ukázkovou sestavu najdete v ukázkové sestavě doby trvání úlohy kanálu.	✔️	✔️
PipelineTask/ PipelineTasks	Vlastnosti pro úlohy, které se používají v rámci kanálu	✔️	✔️
TaskAgentPoolSizeSnapshot/ TaskAgentPoolSizeSnapshots	(složené) Podporuje pochopení velikosti fondu, úloh kanálu a souběžnosti. Historický graf fondů agentů znázorňuje způsob použití této sady entit.		✔️
TaskAgentRequestSnapshot/ TaskAgentRequestSnapshots	(složené)		✔️

Testování typů entit a sad entit

Následující typy entit a sady entit jsou podporovány ve verzi v3.0-Preview nebo v4.0-preview Analytics. Úplný odkaz najdete v tématu Referenční informace o testovacích metadatech.

EntityType/EntitySet	Popis	v3.0-preview	v4.0-preview
TestConfiguration/ TestConfigurations	Informace o konfiguraci testovacího plánu Podrobnosti o konfiguraci testů najdete v tématu Testování různých konfigurací.	✔️	✔️
TestResult/ TestResults	Výsledky jednotlivých spuštění pro konkrétní test přidružený k testovacímu spuštění.	✔️	✔️
TestResultsDaily/ TestResultsDaily	Denní agregace snímků spuštění TestResult seskupené podle testu (ne TestRun). Ukázkovou sestavu najdete v části Ukázka ukázkové sestavy trendu testu.	✔️	✔️
Testovací spuštění/ Testovací běhy	Informace o spuštění testů v rámci kanálu s agregovaným testResult.	✔️	✔️
Testování/ Testy	Vlastnosti testovacího případu, například název testu a vlastník testu. Podrobnosti o definování testovacích případů najdete v tématu Vytvoření ručních testovacích případů.	✔️	✔️
TestPoint/ TestPoints	Informace o spuštění pro testovací body Testovací bod je jedinečná kombinace testovacího případu, sady testů, konfigurace a testera. Ukázkovou sestavu najdete v ukázkové sestavě stavu průběhu.	✔️	✔️
TestPointHistorySnapshot/ TestPointHistorySnapshots	(složené) Výsledky jednotlivých spuštění pro konkrétní test přidružený k testovacímu spuštění. Ukázkovou sestavu najdete v ukázkové sestavě trendu ručního spuštění testu.	✔️	✔️
TestSuite/ TestSuites	Informace o sadách testů Podrobnosti o definování sad testů najdete v tématu Vytvoření testovacích plánů a testovacích sad.	✔️	✔️

Související články

• Pokyny pro dotazy OData Analytics
• Analýza WIT
• Agregace dat
• Zkoumání metadat OData Analytics
• Sledování práce, pracovní procesy a limity projektů
• Návrh datové sady zobrazení analýzy