Partilhar via


Visão geral de relatórios de exemplo usando consultas OData

Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022

Você pode usar consultas OData (Open Data Protocol) para gerar relatórios do Power BI. Para vários serviços no Azure DevOps, consultas de exemplo estão disponíveis para gerar vários relatórios populares. Este artigo fornece uma visão geral dos relatórios de exemplo e mostra como começar a usá-los.

Relatórios de exemplo

Os artigos a seguir fornecem consultas e etapas para gerar os relatórios de exemplo.

Azure Boards

Planos de teste do Azure



Azure Pipelines

Testes do Azure Pipelines



Todos os artigos de relatório de exemplo fornecem as seguintes seções e informações:

  • Consultas de exemplo - A consulta do Power BI e a consulta OData bruta usadas para extrair dados para o Power BI junto com outras consultas de exemplo
  • Uma seção sobre como transformar dados no Power BI - Etapas para transformar os dados em um formato relatável expandindo colunas ou alterando tipos de dados de coluna
  • Criar o relatório - Etapas para criar um relatório básico a partir dos dados
Categoria Requerimentos
Níveis de acesso - Membro do projeto.
- Pelo menos acesso básico .
Permissões Por padrão, os membros do projeto têm permissão para consultar o Google Analytics e criar modos de exibição. Para obter mais informações sobre outros pré-requisitos relacionados com a ativação de serviços e funcionalidades e atividades gerais de monitorização de dados, consulte Permissões e pré-requisitos para aceder ao Analytics.

Executar uma consulta do Power BI

Para começar a incorporar uma consulta OData em uma consulta do Power BI, execute as etapas a seguir. Você pode colar consultas diretamente no Editor Avançado no Power BI.

  1. No Power BI, selecione Obter dados e, em seguida, selecione Consulta em branco.

    Captura de ecrã de um relatório em branco no Power BI Desktop. Na barra de menu, Obter dados é expandido. Obter dados e Consulta em branco são realçados.

  2. No Power BI Power Query Editor, selecione Editor Avançado.

    Captura de ecrã do Editor do Power BI Power Query. Na faixa de opções, no grupo Consulta, o Editor Avançado é realçado.

    A janela Editor Avançado é aberta.

    Captura de ecrã da janela Editor Avançado no Power BI. Um campo escassamente preenchido está disponível para editar uma consulta.

  3. Substitua o conteúdo por uma consulta de exemplo. Para consultas de exemplo, consulte os artigos vinculados listados anteriormente neste artigo.

    Captura de ecrã da janela do Editor Avançado no Power BI. O campo de consulta contém uma consulta para erros. A sintaxe da consulta inclui espaços reservados.

  4. Substitua quaisquer variáveis na consulta pelos seus próprios valores.

    • {organization} - Nome da sua organização.
    • {project} - O nome do projeto da sua equipa. Para uma consulta que abrange vários projetos, omita /{project} completamente.

    Algumas consultas de exemplo contêm outros espaços reservados que você também precisa substituir, como as seguintes cadeias de caracteres:

    • {areapath} - O caminho da sua área, no seguinte formato: Project\Level1\Level2.
    • {iterationpath} - Seu caminho de iteração, no seguinte formato: Project\Level1\Level2.
    • {startdate} - A data para iniciar o seu relatório de tendências, no seguinte formato: YYYY-MM-DDZ. Por exemplo, 2025-04-01Z representa 1º de abril de 2025. Não coloque a data entre aspas.

    Captura de ecrã da janela do Editor Avançado. A organização, o projeto, o caminho da área e a data de início usam valores reais e são realçados.

  5. Para executar a consulta, selecione Concluído.

    Quando você se conecta à sua conta pela primeira vez, o Power BI exige que você se autentique. Para obter informações detalhadas, consulte Inserir credenciais de cliente no Power BI ou Excel.

Executar uma consulta OData bruta

Além de uma consulta do Power BI, a maioria dos relatórios de exemplo também fornece uma consulta OData. Você pode modificar e testar a consulta OData separadamente antes de usá-la no Power BI. Este método proporciona mais flexibilidade, mas envolve etapas extras. Para obter mais informações, consulte Conectar-se com dados usando consultas do Power BI e OData.

Para obter mais informações sobre como escrever consultas OData em dados do Google Analytics, consulte Relatórios de exemplo e índice de referência rápida.