Modelo de datos para Analytics

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

El modelo de datos de Analytics para Azure DevOps consta de conjuntos de entidades, cuyos miembros (entidades) contienen propiedades que se pueden filtrar, agregar y resumir. Además, contienen propiedades de navegación que relacionan entidades entre sí, lo que proporciona acceso a otras propiedades para seleccionar, filtrar y agrupar.

Espacios de nombres de esquema

El modelo de datos de Analytics se basa en dos espacios de nombres de esquema:

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

Conjuntos de entidades y tipos de entidad

Los tipos de entidad se denominan tipos estructurados con una clave. Definen las propiedades y relaciones con nombre de cada entidad. La clave de se EntityType forma a partir de un subconjunto de las propiedades primitivas, por ejemplo, WorkItemId, PipelineId, ReleasePipelineId y mucho más del tipo de entidad.

Los conjuntos de entidades se denominan colecciones de entidades. Por ejemplo, WorkItems es un conjunto de entidades que contiene WorkItem entidades. La clave de una entidad identifica de forma única la entidad dentro de un conjunto de entidades. Si varios conjuntos de entidades usan el mismo tipo de entidad, la misma combinación de valores de clave puede aparecer en más de un conjunto de entidades e identifica diferentes entidades, una por conjunto de entidades donde aparece esta combinación de claves. Cada una de estas entidades tiene un identificador de entidad diferente. Los conjuntos de entidades proporcionan puntos de entrada en el modelo de datos.

Los conjuntos de entidades se describen en metadatos de OData y varían según el proyecto. Puede explorar la lista completa de conjuntos de entidades, tipos de entidad y propiedades solicitando los metadatos de OData para el proyecto. Para obtener información sobre cómo hacerlo, consulte Construcción de consultas de OData para Analytics.

Entidades compuestas

Las entidades compuestas admiten escenarios específicos. Se componen de entidades más sencillas, a menudo requieren más recursos informáticos para generar y pueden devolver conjuntos de resultados más grandes. Para lograr el mejor rendimiento y evitar la limitación innecesaria, asegúrese de consultar la entidad correcta para su escenario.

Por ejemplo, WorkItemSnapshot combina WorkItemRevisions y Dates de modo que cada fecha tiene una revisión para cada elemento de trabajo. Esta representación admite consultas de OData que se centran en los datos de tendencia para un conjunto filtrado de elementos de trabajo. Sin embargo, no debe usar esta entidad compuesta para consultar el estado actual de los elementos de trabajo. En su lugar, debe usar el WorkItems conjunto de entidades para generar una consulta de ejecución más rápida.

De forma similar, algunas entidades pueden contener todos los valores históricos, mientras que otras solo pueden contener valores actuales. WorkItemRevisions contiene todo el historial de elementos de trabajo, que no debe usar en escenarios en los que los valores actuales son de interés.

Relaciones

Para generar resultados de consulta más complejos, puede combinar entidades mediante relaciones. Puede emplear relaciones para expandir, filtrar o resumir datos.

Algunas propiedades de navegación dan como resultado una sola entidad, mientras que otras dan como resultado una colección de entidades. En el diagrama siguiente se muestran las entidades seleccionadas y sus propiedades de navegación. Para mayor claridad, se han omitido algunas entidades compuestas y relaciones.

Claves de relación

Las relaciones de entidad también se representan como claves externas para que las herramientas externas puedan unir entidades. Estas propiedades tienen el sufijo "SK" y son tipos de datos enteros o GUID. Las propiedades de fecha tienen propiedades de clave de fecha entera correspondientes con el siguiente formato: AAAAMMDD.

Tipos de entidad y conjuntos de entidades de seguimiento de trabajos

Los siguientes tipos de entidad y conjuntos de entidades se admiten con las versiones de API indicadas. Para obtener una referencia completa, consulte Referencia de metadatos de seguimiento del trabajo para Azure Boards Analytics.

Artículos relacionados

• Directrices de consulta de OData Analytics
• Análisis de WIT
• Agregar datos
• Exploración de metadatos de OData de Analytics
• Seguimiento del trabajo, proceso y límites del proyecto
• Diseño de conjuntos de datos de vistas de análisis