Modelo de dados para Análise

Serviços do Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019

O modelo de dados de Análise do Azure DevOps consiste em conjuntos de entidades, cujos membros (entidades) contêm propriedades que podem ser filtradas, agregadas e resumidas. Além disso, contêm propriedades de navegação que relacionam entidades entre si, fornecendo acesso a outras propriedades para selecionar, filtrar e agrupar.

Nota

O serviço DevOps do Azure é automaticamente ativado e suportado em produção para todos os Serviços do Azure DevOps. A integração do Power BI e o acesso ao feed OData do Serviço de Análise estão geralmente disponíveis. Encorajamo-lo a utilizá-lo e a dar-nos feedback. Os dados disponíveis dependem da versão. A versão suportada mais recente é v2.0e a versão de pré-visualização mais recente é v4.0-preview. Para obter mais informações, veja Controlo de versões da API OData.

Espaços de nomes de esquema

O modelo de dados do Analytics baseia-se em dois espaços de nomes de esquema:

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

Conjuntos de entidades e tipos de entidade

Os tipos de entidade são denominados tipos estruturados com uma chave. Definem as propriedades e relações nomeadas de cada entidade. A chave de um EntityType é formada a partir de um subconjunto das propriedades primitivas, por exemplo : WorkItemId, PipelineId, ReleasePipelineId — e muito mais do tipo de entidade.

Os conjuntos de entidades são coleções nomeadas de entidades. Por exemplo, WorkItems é um conjunto de entidades que WorkItem contém entidades. A chave de uma entidade identifica exclusivamente a entidade dentro de um conjunto de entidades. Se vários conjuntos de entidades utilizarem o mesmo tipo de entidade, a mesma combinação de valores de chave pode aparecer em mais do que um conjunto de entidades e identificar entidades diferentes, uma por conjunto de entidades onde esta combinação de chaves é apresentada. Cada uma destas entidades tem um ID de entidade diferente. Os conjuntos de entidades fornecem pontos de entrada no modelo de dados.

Os conjuntos de entidades são descritos nos metadados OData e variam consoante o projeto. Pode explorar a lista completa de conjuntos de entidades, tipos de entidades e propriedades ao pedir os metadados OData para o projeto. Para saber como, veja Construir consultas OData para Análise.

Entidades compostas

As entidades compostas suportam cenários específicos. São compostos por entidades mais simples, muitas vezes requerem mais recursos de computação para gerar e podem devolver conjuntos de resultados maiores. Para obter o melhor desempenho e evitar limitações desnecessárias, certifique-se de que consulta a entidade correta para o seu cenário.

Por exemplo, WorkItemSnapshot combina WorkItemRevisions e Dates tal que cada data tem uma revisão para cada item de trabalho. Esta representação suporta consultas OData que se focam nos dados de tendência para um conjunto filtrado de itens de trabalho. No entanto, não deve utilizar esta entidade composta para consultar o estado atual dos itens de trabalho. Em vez disso, deve utilizar o WorkItems conjunto de entidades para gerar uma consulta de execução mais rápida.

Da mesma forma, algumas entidades podem conter todos os valores históricos, enquanto outras só podem conter valores atuais. WorkItemRevisions contém todo o histórico de itens de trabalho, que não deve utilizar em cenários em que os valores atuais são de interesse.

Relações

Para gerar resultados de consultas mais complexos, pode combinar entidades com relações. Pode utilizar relações para expandir, filtrar ou resumir dados.

Algumas propriedades de navegação resultam numa única entidade, enquanto outras resultam numa coleção de entidades. O diagrama seguinte mostra as entidades selecionadas e as respetivas propriedades de navegação. Para maior clareza, algumas entidades compostas e relações foram omitidas.

Chaves de relação

As relações entre entidades também são representadas como chaves externas para que as ferramentas externas possam associar entidades. Estas propriedades têm o sufixo "SK" e são tipos de dados guid ou número inteiro. As propriedades de data têm propriedades de chave de data de número inteiro correspondentes com o seguinte formato: AAAAMMDD.

Tipos de entidades e conjuntos de entidades de controlo de trabalho

Os seguintes tipos de entidade e conjuntos de entidades são suportados com as versões de API indicadas. Para obter uma referência completa, veja Referência de metadados de controlo de trabalho para o Azure Boards Analytics.

EntityType/EntitySet	Descrição	v1.0	v2.0	v3.0 - pré-visualização	v4.0-preview
Área/ Áreas	O item de trabalho Caminhos da Área, com propriedades para agrupamento e filtragem por hierarquia de área.	✔️	✔️	✔️	✔️
Iteração/ Iterações	Os Caminhos de Iteração do item de trabalho, com propriedades para agrupamento e filtragem por hierarquia de iteração.	✔️	✔️	✔️	✔️
BoardLocation/ BoardLocations	As localizações das células do quadro Kanban, conforme identificado pela coluna de quadro, pista de diagrama e divisão, incluem definições históricas do quadro. Para obter uma descrição de cada campo de quadro Kanban, veja Workflow and Kanban board fields (Campos de quadro Kanban e Fluxo de Trabalho).	✔️	✔️	✔️	✔️
CalendarDate/ Datas	As datas utilizadas para filtrar e agrupar outras entidades através de relações.	✔️	✔️	✔️	✔️
Projeto/ Projetos	Todos os projetos definidos para uma organização (cloud) ou coleção de projetos (no local).	✔️	✔️	✔️	✔️
Processo/ Processos	Informações de tarefas pendentes utilizadas para expandir ou filtrar itens de trabalho e tipos de itens de trabalho. Para obter um exemplo que utiliza Processos para filtrar um relatório, veja Relatório de exemplo de controlo de requisitos.		✔️	✔️	✔️
Etiqueta/ Etiquetas	Todas as etiquetas de item de trabalho para cada projeto. Para obter um exemplo que utiliza Etiquetas para filtrar um relatório, veja Libertar relatório de exemplo de evolução.	✔️	✔️	✔️	✔️
Equipa/ Teams	Todas as equipas definidas para o projeto. Para obter um exemplo que utiliza o Teams para filtrar um relatório, veja Adicionar uma segmentação de dados equipa a um relatório do Power BI.	✔️	✔️	✔️	✔️
Utilizador/ Utilizadores	Informações de utilizador que são utilizadas para expandir ou filtrar várias propriedades de itens de trabalho, por exemplo Atribuído a, Criado Por.	✔️	✔️	✔️	✔️
WorkItemBoardSnapshot/ WorkItemBoardSnapshot	(Composto) O estado de cada item de trabalho em cada data do calendário, incluindo a localização do quadro Kanban, utilizado para gerar relatórios de tendência. Para obter um relatório de exemplo, veja Relatório de exemplo do Diagrama de Fluxo Cumulativo (CFD).	✔️	✔️	✔️	✔️
WorkItemLink/ WorkItemLinks	As ligações entre itens de trabalho, por exemplo , Subordinado, Principal e Relacionado. Inclui apenas a revisão mais recente das ligações, sem histórico. As hiperligações não estão incluídas.	✔️	✔️	✔️	✔️
WorkItemRevision/ WorkItemRevisions	Todas as revisões históricas de itens de trabalho, incluindo a revisão atual. Não inclui itens de trabalho eliminados.	✔️	✔️	✔️	✔️
WorkItemSnapshot/ WorkItemSnapshot	(Composto) O estado de cada item de trabalho em cada data do calendário, utilizado para suportar relatórios de tendências. Para obter um relatório de exemplo, veja Relatório de exemplo de tendências de erros.	✔️	✔️	✔️	✔️
WorkItem/ WorkItems	O estado atual dos itens de trabalho. Utilizado para suportar relatórios de estado. Para obter um relatório de exemplo, veja Rollup child work item values to parent sample report (Rollup child work item values to parent sample report ).	✔️	✔️	✔️	✔️
WorkItemTypeField/ WorkItemTypeFields	As propriedades do item de trabalho para cada tipo de item de trabalho e processo. Utilizado para suportar a criação de relatórios.	✔️	✔️	✔️	✔️

Tipos de entidades e conjuntos de entidades de pipelines

Os seguintes tipos de entidade e conjuntos de entidades são suportados com a versão v3.0-preview ou v4.0-preview Analytics. Para obter uma referência completa, veja Referência de metadados do pipeline .

EntityType/EntitySet	Descrição	v3.0 - pré-visualização	v4.0-preview
Ramo/ Ramos	Informações básicas sobre ramos utilizados em testes ou pipelines. Para obter um relatório de exemplo, veja Relatório de exemplo de estado de progresso.	✔️	✔️
ParallelPipelineJobsSnapshot/ ParallelPipelineJobsSnapshot	(Composto) Suporta a compreensão do consumo paralelo de pipelines. Para saber mais sobre os testes de pipeline paralelos, veja Executar testes em paralelo com a tarefa de Teste do Visual Studio.		✔️
Pipeline/ Pipelines	Propriedades de um pipeline.	✔️	✔️
PipelineJob/ PipelineJobs	Resultados de execução individuais para um Teste específico associado a uma TestRun	✔️	✔️
PipelineRun/ PipelineRuns	Informações de execução para pipelines. Para obter um relatório de exemplo, veja Relatório de exemplo de tendência de taxa de transmissão de pipelines.	✔️	✔️
PipelineRunActivityResult/ PipelineRunActivityResults	Registo intercalado de todas as fases, passos, tarefas e tarefas numa execução de pipeline específica. Para obter um relatório de exemplo, veja Relatório de exemplo de duração da tarefa de pipeline.	✔️	✔️
PipelineTask/ PipelineTasks	Propriedades para tarefas que são utilizadas num pipeline.	✔️	✔️
TaskAgentPoolSizeSnapshot/ TaskAgentPoolSizeSnapshots	(Composto) Suporta a compreensão do tamanho do conjunto, das tarefas de pipeline e da simultaneidade. O gráfico Histórico para conjuntos de agentes ilustra como este conjunto de entidades pode ser utilizado.		✔️
TaskAgentRequestSnapshot/ TaskAgentRequestSnapshots	(Composto)		✔️

Testar tipos de entidades e conjuntos de entidades

Os seguintes tipos de entidade e conjuntos de entidades são suportados com a versão v3.0-preview ou v4.0-preview Analytics. Para obter uma referência completa, veja Referência de metadados de teste.

EntityType/EntitySet	Descrição	v3.0 - pré-visualização	v4.0-preview
TestConfiguration/ TestConfigurations	Informações de configuração do plano de teste. Para obter detalhes sobre como configurar testes, veja Testar diferentes configurações	✔️	✔️
TestResult/ TestResults	Resultados de execução individuais para um Teste específico associado a uma TestRun.	✔️	✔️
TestResultsDaily/ TestResultsDaily	Uma agregação diária de instantâneos de execuções testResult , agrupadas por Test (não TestRun). Para obter um relatório de exemplo, veja Testar relatório de exemplo de tendência de resumo.	✔️	✔️
TestRun/ TestRuns	As informações de execução dos testes são executadas num pipeline com TestResult agregado.	✔️	✔️
Teste/ Testes	Propriedades de um caso de teste, como o nome do teste e o proprietário do teste. Para obter detalhes sobre a definição de casos de teste, veja Criar casos de teste manuais.	✔️	✔️
TestPoint/ TestPoints	Informações de execução para pontos de teste. Um ponto de teste é uma combinação exclusiva de caso de teste, conjunto de testes, configuração e testador. Para obter um relatório de exemplo, veja Relatório de exemplo de estado de progresso.	✔️	✔️
TestPointHistorySnapshot/ TestPointHistorySnapshots	(Composto) Resultados de execução individuais para um Teste específico associado a uma TestRun. Para obter um relatório de exemplo, veja Relatório de exemplo de tendência de execução de testes manual	✔️	✔️
TestSuite/ TestSuites	Informações dos conjuntos de testes. Para obter detalhes sobre a definição de conjuntos de testes, veja Criar planos de teste e conjuntos de testes.	✔️	✔️

Artigos relacionados

• Diretrizes de consulta do OData Analytics
• Análise de WIT
• Agregar dados
• Explorar metadados OData da Análise
• Limites do projeto, processo e controlo do trabalho
• Estrutura do conjunto de dados de vistas de análise