Modello di dati per Analytics

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Il modello di dati di Analisi per Azure DevOps è costituito da set di entità, i cui membri (entità) contengono proprietà che possono essere filtrate, aggregate e riepilogate. Contengono inoltre proprietà di navigazione correlate tra le entità, fornendo l'accesso ad altre proprietà per la selezione, il filtro e il raggruppamento.

Namespace dello schema

Il modello di dati di Analytics si basa su due namespace dello schema.

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

Set di entità e tipi di entità

I tipi di entità sono tipi strutturati denominati con una chiave. Definiscono le proprietà e le relazioni denominate di ogni entità. La chiave di un EntityType è formata da un subset delle proprietà primitive, ad esempio, WorkItemId, PipelineId, ReleasePipelineId e altre del tipo di entità.

I set di entità sono collezioni denominate di entità. Ad esempio, WorkItems è un set di entità contenente WorkItem entità. La chiave di un'entità identifica in modo univoco l'entità all'interno di un set di entità. Se più set di entità usano lo stesso tipo di entità, la stessa combinazione di valori di chiave può essere visualizzata in più set di entità e identifica entità diverse, una per ogni set di entità in cui viene visualizzata questa combinazione di chiavi. Ognuna di queste entità ha un ID entità diverso. I set di entità forniscono punti di ingresso nel modello di dati.

I set di entità sono descritti nei metadati OData e variano in base al progetto. È possibile esplorare l'elenco completo di set di entità, tipi di entità e proprietà richiedendo i metadati OData per il progetto. Per informazioni su come, vedere Creare query OData per Analytics.

Entità composte

Le entità composite supportano scenari specifici. Sono costituiti da entità più semplici, spesso richiedono più risorse di calcolo da generare e possono restituire set di risultati più grandi. Per ottenere le migliori prestazioni ed evitare limitazioni non necessarie, assicurati di eseguire una query sull'entità corretta per il tuo scenario.

Ad esempio, WorkItemSnapshot combina WorkItemRevisions e Dates in modo che ogni data abbia una revisione per ogni elemento di lavoro. Questa rappresentazione supporta le query OData che si concentrano sui dati di tendenza per un set filtrato di elementi di lavoro. Tuttavia, non è consigliabile usare questa entità composita per eseguire query sullo stato corrente degli elementi di lavoro. È invece consigliabile usare il WorkItems set di entità per generare una query con esecuzione più rapida.

Analogamente, alcune entità possono contenere tutti i valori cronologici, mentre altri possono contenere solo valori correnti. WorkItemRevisions contiene tutta la cronologia degli elementi di lavoro, che non è consigliabile usare negli scenari in cui i valori correnti sono di interesse.

Relazioni

Per generare risultati di query più complessi, è possibile combinare le entità usando le relazioni. È possibile usare le relazioni per espandere, filtrare o riepilogare i dati.

Alcune proprietà di navigazione generano una singola entità, mentre altre generano una raccolta di entità. Il diagramma seguente mostra le entità selezionate e le relative proprietà di navigazione. Per maggiore chiarezza, alcune entità composite e relazioni sono state omesse.

Chiavi di relazione

Le relazioni di entità sono rappresentate anche come chiavi esterne in modo che gli strumenti esterni possano unire entità. Queste proprietà hanno il suffisso "SK" e sono tipi di dati integer o GUID. Le proprietà della data hanno proprietà chiave di data intera corrispondenti con il formato seguente: AAAAMMGG.

Tipi di entità e set di entità di monitoraggio del lavoro

I tipi di entità e i set di entità seguenti sono supportati con le versioni API indicate. Per un riferimento completo, vedere Riferimento sui metadati di monitoraggio del lavoro per Azure Boards Analytics.

Articoli correlati

• Linee guida per le query di OData Analytics
• Analisi del WIT
• Dati aggregati
• Esplorazione dei metadati OData di Analytics
• Limiti del rilevamento del lavoro, dei processi e dei progetti
• Progettazione del set di dati delle visualizzazioni di Analisi