Modèle de données pour Analytics

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

Le modèle de données Analytique pour Azure DevOps se compose de jeux d’entités, dont les membres (entités) contiennent des propriétés qui peuvent être filtrées, agrégées et résumées. En outre, ils contiennent des propriétés de navigation qui associent des entités à l’autre, fournissant l’accès à d’autres propriétés pour la sélection, le filtrage et le regroupement.

Espaces de noms de schéma

Le modèle de données Analytique est basé sur deux espaces de noms de schéma :

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

Jeux d’entités et types d’entités

Les types d’entités sont nommés types structurés avec une clé. Ils définissent les propriétés et relations nommées de chaque entité. La clé d’un élément EntityType est formée à partir d’un sous-ensemble des propriétés primitives, par exemple, WorkItemId, PipelineId, ReleasePipelineId, et plus encore du type d’entité.

Les jeux d’entités sont des collections nommées d’entités. Par exemple, WorkItems il s’agit d’un jeu d’entités contenant des WorkItem entités. La clé d’une entité identifie de façon unique l’entité au sein d’un jeu d’entités. Si plusieurs jeux d’entités utilisent le même type d’entité, la même combinaison de valeurs de clé peut apparaître dans plusieurs ensembles d’entités et identifie différentes entités, une par jeu d’entités où cette combinaison de clés s’affiche. Chacune de ces entités a un ID d’entité différent. Les jeux d’entités fournissent des points d’entrée dans le modèle de données.

Les jeux d’entités sont décrits dans les métadonnées OData et varient selon le projet. Vous pouvez explorer la liste complète des jeux d’entités, des types d’entités et des propriétés en demandant les métadonnées OData pour votre projet. Pour en savoir plus, consultez Créer des requêtes OData pour Analytique.

Entités composées

Les entités composites prennent en charge des scénarios spécifiques. Elles sont composées d’entités plus simples, nécessitent souvent davantage de ressources informatiques pour générer et peuvent retourner des jeux de résultats plus volumineux. Pour obtenir les meilleures performances et éviter une limitation inutile, veillez à interroger l’entité appropriée pour votre scénario.

Par exemple, WorkItemSnapshot combine et WorkItemRevisions Dates telle que chaque date a une révision pour chaque élément de travail. Cette représentation prend en charge les requêtes OData qui se concentrent sur les données de tendance pour un ensemble filtré d’éléments de travail. Toutefois, vous ne devez pas utiliser cette entité composite pour interroger l’état actuel des éléments de travail. Au lieu de cela, vous devez utiliser l’ensemble WorkItems d’entités pour générer une requête plus rapide.

De même, certaines entités peuvent contenir toutes les valeurs historiques, tandis que d’autres peuvent contenir uniquement des valeurs actuelles. WorkItemRevisions contient l’historique des éléments de travail, que vous ne devez pas utiliser dans les scénarios où les valeurs actuelles sont intéressantes.

Relations

Pour générer des résultats de requête plus complexes, vous pouvez combiner des entités à l’aide de relations. Vous pouvez utiliser des relations pour développer, filtrer ou synthétiser des données.

Certaines propriétés de navigation entraînent une entité unique, tandis que d’autres entraînent une collection d’entités. Le diagramme suivant montre les entités sélectionnées et leurs propriétés de navigation. Pour plus de clarté, certaines entités et relations composites ont été omises.

Clés de relation

Les relations d’entité sont également représentées en tant que clés étrangères afin que les outils externes puissent joindre des entités. Ces propriétés ont le suffixe « SK » et sont des types de données entiers ou GUID. Les propriétés de date ont des propriétés de clé de date entière correspondantes au format suivant : AAAAMMDD.

Types d’entités et jeux d’entités de suivi du travail

Les types d’entités et les jeux d’entités suivants sont pris en charge avec les versions d’API indiquées. Pour obtenir une référence complète, consultez la référence des métadonnées de suivi des tâches pour Azure Boards Analytique.

Articles connexes

• Instructions relatives aux requêtes OData Analytics
• ANALYTIQUE WIT
• Données agrégées
• Exploration des métadonnées OData Analytique
• Limites du suivi du travail, des processus et des projets
• conception du jeu de données Analytique vues