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.

Anteckning

Analytics-tjänsten aktiveras automatiskt och stöds i produktion för alla Azure DevOps-tjänster. Power BI-integrering och åtkomst till OData-flödet för Analystjänsten ä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.0och den senaste förhandsversionen är v4.0-preview. Mer information finns i OData API-versionshantering.

Schemanamnområden

Analysdatamodellen baseras på två schemanamnrymder:

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

Entitetsuppsättningar och entitetstyper

Entitetstyper kallas 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 är namngivna samlingar av entiteter. Är till exempel WorkItems en entitetsuppsättning som innehåller WorkItem entiteter. En entitetsnyckel identifierar entiteten i en entitetsuppsättning unikt. Om flera entitetsuppsättningar använder samma entitetstyp kan samma kombination av nyckelvärden visas i fler ä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 fler beräkningsresurser för 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.

Kombinerar WorkItemRevisions till exempel WorkItemSnapshot 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 snabbare 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 arbetsobjekthistorik 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. Vissa sammansatta entiteter och relationer har utelämnats för tydlighetens skull.

Relationsnycklar

Entitetsrelationer representeras också som sekundärnycklar så att externa verktyg kan koppla 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.

Entitetstyper och entitetsuppsättningar för arbetsspårning

Följande entitetstyper och entitetsuppsättningar stöds med angivna API-versioner. 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-förhandsversion
Området/ 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	Kanban-styrelsens cellplatser, som identifieras av brädkolumn, simbana och delning, innehåller historiska styrelseinställningar. En beskrivning av varje Kanban-brädfält finns i fälten Arbetsflöde och Kanban-bräde.	✔️	✔️	✔️	✔️
CalendarDate/ Datum	Datumen som används för att filtrera och gruppera andra entiteter med hjälp av relationer.	✔️	✔️	✔️	✔️
Project/ Projekt	Alla projekt som definierats för en organisation (moln) eller projektsamling (lokalt).	✔️	✔️	✔️	✔️
Process/ 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.		✔️	✔️	✔️
Etiketten/ Taggar	Alla arbetsobjekttaggar för varje projekt. Ett exempel som använder taggar för att filtrera en rapport finns i Exempelrapport för lansering av nedbrändhet.	✔️	✔️	✔️	✔️
Team/ 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ändaren/ Användare	Användarinformation som används för att expandera eller filtrera olika egenskaper för arbetsobjekt, till exempel Tilldelad,Skapad av.	✔️	✔️	✔️	✔️
WorkItemBoardSnapshot/ WorkItemBoardSnapshot	(Sammansatt) Tillståndet för varje arbetsobjekt på varje kalenderdatum, inklusive Kanban-anslagstavlans plats, 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 bara 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	Aktuellt tillstånd för arbetsobjekt. Används för att stödja statusrapporter. En exempelrapport finns i Samla in underordnade arbetsobjektvärden till den överordnade exempelrapporten.	✔️	✔️	✔️	✔️
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 versionen 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 för alla steg, steg, jobb och uppgifter i en specifik pipelinekörning. En exempelrapport finns i Exempelrapport för varaktighet för pipelineaktivitet.	✔️	✔️
PipelineTask/ PipelineTasks	Egenskaper för aktiviteter som används i en pipeline.	✔️	✔️
TaskAgentPoolSizeSnapshot/ TaskAgentPoolSizeSnapshots	(Sammansatt) Stöder förståelse för poolstorlek, pipelinejobb och samtidighet. Diagrammet Historiska för agentpooler illustrerar 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 versionen 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 som körs under en pipeline med aggregerade TestResult.	✔️	✔️
Test/ 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

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