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ödig strypning, säkerställ att du söker efter 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.

Nycklar för relationer

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.

Typer av entiteter för arbetsspårning och entitetsgrupper

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
Område/ 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	Cellerna, som är identifierade av kolumn, simlinje och delning, innehåller historiska tavlans inställningar. En beskrivning av varje tavelfält finns i Arbetsflöde och tavelfält.	✔️	✔️	✔️	✔️
CalendarDate/ Datum	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 exempelrapport för release burndown.	✔️	✔️	✔️	✔️
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 placering på tavlan, som används för att generera trendrapporter. En exempelrapport finns i Exempelrapport för kumulativt flödesdiagram (CFD).	✔️	✔️	✔️	✔️
WorkItemLink/ Arbetsobjektlänkar	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. För en exempelrapport, se Sammanställ värden för underordnade arbetsobjekt till en överordnad exempelrapport.	✔️	✔️	✔️	✔️
WorkItemTypeField/ ArbetsobjektTypFält	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. För en exempelrapport, se Exempelrapport för status.	✔️	✔️
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, etapper, jobb och uppgifter i en specifik pipelinekörning. För en exempelrapport, se Exempelrapport för varaktigheten av pipelineuppgifter.	✔️	✔️
PipelineTask/ PipelineTasks	Egenskaper för uppgifter som används i en pipeline.	✔️	✔️
TaskAgentPoolSizeSnapshot/ TaskAgentPoolSizeSnapshots	(Sammansatt) Underlättar förståelsen av poolstorlek, pipelinejobb och parallellitet. 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 kopplat till en testrun.	✔️	✔️
TestResultsDaily/ TestResultsDaily	En daglig sammanställning 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 testresultat.	✔️	✔️
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. För en exempelrapport, se Exempelrapport för status för framsteg.	✔️	✔️
TestPointHistorySnapshot/ TestPointHistorySnapshots	(Sammansatt) Individuella körningsresultat för ett specifikt test som är associerat med en Testkörning. För en exempelrapport, se Exempelrapport över trend för manuell testkörning	✔️	✔️
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
• Aggregerad data
• Utforska Analytics OData-metadata
• Arbetsspårning, processer och projektgränser
• Analys visar datauppsättningsdesign