Datamodell för analys

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

Analysdatamodellen för Azure DevOps består av entitetsuppsättningar vars medlemmar (entiteter) innehåller egenskaper som kan filtreras, aggregeras och sammanfattas. Dessutom innehåller de navigeringsegenskaper som relaterar entiteter till varandra, vilket ger åtkomst till andra egenskaper för att välja, filtrera och gruppera.

Kommentar

Analytics-tjänsten aktiveras automatiskt och stöds i produktion för alla Azure DevOps Services. Power BI-integrering och åtkomst till OData-flödet i Analytics Service är allmänt tillgängliga. Vi rekommenderar att du använder den och ger oss feedback. Tillgängliga data är versionsberoende. Den senaste versionen som stöds är v2.0, och den senaste förhandsversionen är v4.0-preview. Mer information finns i OData API-versionshantering.

Schemanamnområden

Analysdatamodellen baseras på två schemanamnområden:

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

Entitetsuppsättningar och entitetstyper

Entitetstyper heter strukturerade typer med en nyckel. De definierar namngivna egenskaper och relationer för varje entitet. Nyckeln för en EntityType skapas från en delmängd av de primitiva egenskaperna, till exempel WorkItemId, PipelineId, ReleasePipelineId och mer av entitetstypen.

Entitetsuppsättningar heter samlingar av entiteter. Är till exempel WorkItems en entitetsuppsättning som innehåller WorkItem entiteter. En entitetsnyckel identifierar unikt entiteten i en entitetsuppsättning. Om flera entitetsuppsättningar använder samma entitetstyp kan samma kombination av nyckelvärden visas i mer än en entitetsuppsättning och identifierar olika entiteter, en per entitetsuppsättning där den här nyckelkombinationen visas. Var och en av dessa entiteter har olika entitets-ID. Entitetsuppsättningar ger startpunkter i datamodellen.

Entitetsuppsättningar beskrivs i OData-metadata och varierar beroende på projekt. Du kan utforska den fullständiga listan över entitetsuppsättningar, entitetstyper och egenskaper genom att begära OData-metadata för projektet. Mer information finns i Skapa OData-frågor för analys.

Sammansatta entiteter

Sammansatta entiteter stöder specifika scenarier. De består av enklare entiteter, kräver ofta mer databehandlingsresurser att generera och kan returnera större resultatuppsättningar. För att uppnå bästa prestanda och undvika onödiga begränsningar kontrollerar du att du frågar rätt entitet för ditt scenario.

Till exempel WorkItemSnapshot kombinerar WorkItemRevisions och Dates så att varje datum har en revision för varje arbetsobjekt. Den här representationen stöder OData-frågor som fokuserar på trenddata för en filtrerad uppsättning arbetsobjekt. Du bör dock inte använda den här sammansatta entiteten för att fråga efter arbetsobjektens aktuella tillstånd. I stället bör du använda entitetsuppsättningen WorkItems för att generera en mer snabbkörande fråga.

På samma sätt kan vissa entiteter innehålla alla historiska värden, medan andra bara innehåller aktuella värden. WorkItemRevisions innehåller all arbetsobjektshistorik, som du inte bör använda i scenarier där de aktuella värdena är av intresse.

Relationer

Om du vill generera mer komplexa frågeresultat kan du kombinera entiteter med hjälp av relationer. Du kan använda relationer för att expandera, filtrera eller sammanfatta data.

Vissa navigeringsegenskaper resulterar i en enda entitet, medan andra resulterar i en samling entiteter. Följande diagram visar välj entiteter och deras navigeringsegenskaper. För tydlighetens skull har vissa sammansatta entiteter och relationer utelämnats.

Relationsnycklar

Entitetsrelationer representeras också som sekundärnycklar så att externa verktyg kan ansluta entiteter. Dessa egenskaper har suffixet "SK" och är antingen heltals- eller GUID-datatyper. Datumegenskaper har motsvarande egenskaper för heltalsdatumnyckel med följande format: ÅÅÅÅMMDD.

Arbetsspårningsentitetstyper och entitetsuppsättningar

Följande entitetstyper och entitetsuppsättningar stöds med de angivna API-versionerna. En fullständig referens finns i Referens för arbetsspårningsmetadata för Azure Boards Analytics.

EntityType/EntitySet	beskrivning	V1.0	V2.0	v3.0-förhandsversion	v4.0-preview
Ytdiagram/ Områden	Arbetsobjektets områdessökvägar med egenskaper för gruppering och filtrering efter områdeshierarki.	✔️	✔️	✔️	✔️
Iteration/ Iterationer	Iterationssökvägar för arbetsobjekt med egenskaper för gruppering och filtrering efter iterationshierarki.	✔️	✔️	✔️	✔️
BoardLocation/ BoardLocations	Brädcellsplatserna, som identifieras av brädkolumn, simbana och delning, innehåller historiska styrelseinställningar. En beskrivning av varje brädfält finns i Fält för arbetsflöde och tavla.	✔️	✔️	✔️	✔️
CalendarDate/ Dadlar	Datumen som används för att filtrera och gruppera andra entiteter med hjälp av relationer.	✔️	✔️	✔️	✔️
Projekt/ Projekt	Alla projekt som definierats för en organisation (moln) eller projektsamling (lokalt).	✔️	✔️	✔️	✔️
Bearbeta/ Processer	Information om kvarvarande uppgifter som används för att expandera eller filtrera arbetsobjekt och typer av arbetsobjekt. Ett exempel som använder Processer för att filtrera en rapport finns i Exempelrapport för kravspårning.		✔️	✔️	✔️
Tag/ Taggar	Alla arbetsobjekttaggar för varje projekt. Ett exempel som använder taggar för att filtrera en rapport finns i Avsnittet om exempelrapport för lansering av nedbrändhet.	✔️	✔️	✔️	✔️
Lag/ Teams	Alla team som definierats för projektet. Ett exempel som använder Teams för att filtrera en rapport finns i Lägga till ett team-utsnitt i en Power BI-rapport.	✔️	✔️	✔️	✔️
Användare/ Användare	Användarinformation som används för att expandera eller filtrera olika egenskaper för arbetsobjekt, till exempel Tilldelad till, Skapad av.	✔️	✔️	✔️	✔️
WorkItemBoardSnapshot/ WorkItemBoardSnapshot	(Sammansatt) Tillståndet för varje arbetsobjekt på varje kalenderdatum, inklusive styrelseplats, som används för att generera trendrapporter. En exempelrapport finns i Exempelrapport för kumulativt flödesdiagram (CFD).	✔️	✔️	✔️	✔️
WorkItemLink/ WorkItemLinks	Länkarna mellan arbetsobjekt, till exempel Underordnad, Överordnad och Relaterad. Innehåller endast den senaste versionen av länkar, ingen historik. Hyperlänkar ingår inte.	✔️	✔️	✔️	✔️
WorkItemRevision/ WorkItemRevisions	Alla historiska arbetsobjektsrevisioner, inklusive den aktuella revisionen. Innehåller inte borttagna arbetsobjekt.	✔️	✔️	✔️	✔️
WorkItemSnapshot/ WorkItemSnapshot	(Sammansatt) Tillståndet för varje arbetsobjekt på varje kalenderdatum, som används för att stödja trendrapportering. En exempelrapport finns i Exempelrapport för buggtrender.	✔️	✔️	✔️	✔️
WorkItem/ WorkItems	Arbetsobjektens aktuella tillstånd. Används för att stödja statusrapporter. En exempelrapport finns i Samla in underordnade arbetsobjektvärden till en överordnad exempelrapport.	✔️	✔️	✔️	✔️
WorkItemTypeField/ WorkItemTypeFields	Egenskaperna för arbetsobjekt för varje typ och process av arbetsobjekt. Används för att skapa rapporter.	✔️	✔️	✔️	✔️

Pipelines-entitetstyper och entitetsuppsättningar

Följande entitetstyper och entitetsuppsättningar stöds med versionerna v3.0-preview eller v4.0-preview Analytics. En fullständig referens finns i Referens för pipelinemetadata .

EntityType/EntitySet	beskrivning	v3.0-förhandsversion	v4.0-preview
Gren/ Grenar	Grundläggande information om grenar som används i tester eller pipelines. En exempelrapport finns i Exempelrapport för statusstatus.	✔️	✔️
ParallelPipelineJobsSnapshot/ ParallelPipelineJobsSnapshot	(Sammansatt) Stöder förståelse för parallell pipelineförbrukning. Mer information om parallella pipelinetester finns i Köra tester parallellt med hjälp av Visual Studio-testuppgiften.		✔️
Rörledning/ Pipelines	Egenskaper för en pipeline.	✔️	✔️
PipelineJob/ PipelineJobs	Enskilda körningsresultat för ett specifikt test som är associerat med en TestRun	✔️	✔️
PipelineRun/ PipelineRuns	Körningsinformation för pipelines. En exempelrapport finns i Exempelrapport för pipelineflödestrend.	✔️	✔️
PipelineRunActivityResult/ PipelineRunActivityResults	Sammanslagen logg över alla steg, steg, jobb och uppgifter i en specifik pipelinekörning. En exempelrapport finns i Exempelrapport för pipelineaktivitetsvaraktighet.	✔️	✔️
PipelineTask/ PipelineTasks	Egenskaper för uppgifter som används i en pipeline.	✔️	✔️
TaskAgentPoolSizeSnapshot/ TaskAgentPoolSizeSnapshots	(Sammansatt) Stöder förståelse för poolstorlek, pipelinejobb och samtidighet. Det historiska diagrammet för agentpooler visar hur den här entitetsuppsättningen kan användas.		✔️
TaskAgentRequestSnapshot/ TaskAgentRequestSnapshots	(Sammansatt)		✔️

Testa entitetstyper och entitetsuppsättningar

Följande entitetstyper och entitetsuppsättningar stöds med versionerna v3.0-preview eller v4.0-preview Analytics. En fullständig referens finns i Referens för testmetadata.

EntityType/EntitySet	beskrivning	v3.0-förhandsversion	v4.0-preview
TestConfiguration/ TestConfigurations	Konfigurationsinformation för testplan. Mer information om hur du konfigurerar tester finns i Testa olika konfigurationer	✔️	✔️
TestResult/ TestResults	Enskilda körningsresultat för ett specifikt test som är associerat med en TestRun.	✔️	✔️
TestResultsDaily/ TestResultsDaily	En daglig ögonblicksbild av TestResult-körningar , grupperade efter test (inte TestRun). En exempelrapport finns i Exempelrapport för testsammanfattningstrend.	✔️	✔️
TestRun/ TestRuns	Körningsinformation för tester körs under en pipeline med aggregerade TestResult.	✔️	✔️
Testa/ Tester	Egenskaper för ett testfall, till exempel testnamn och testägare. Mer information om hur du definierar testfall finns i Skapa manuella testfall.	✔️	✔️
TestPoint/ TestPoints	Körningsinformation för testpunkter. En testpunkt är en unik kombination av testfall, testpaket, konfiguration och testare. En exempelrapport finns i Exempelrapport för statusstatus.	✔️	✔️
TestPointHistorySnapshot/ TestPointHistorySnapshots	(Sammansatt) Enskilda körningsresultat för ett specifikt test som är associerat med en TestRun. En exempelrapport finns i Exempelrapport för manuell testkörningstrend	✔️	✔️
TestSuite/ TestSuites	Information om testpaket. Mer information om hur du definierar testsviter finns i Skapa testplaner och testsviter.	✔️	✔️

Relaterade artiklar

• OData Analytics-frågeriktlinjer
• WIT-analys
• Aggregera data
• Utforska Analytics OData-metadata
• Arbetsspårning, processer och projektgränser
• Analys visar datauppsättningsdesign