Compartilhar via

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

Azure DevOps Services | 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, as 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.

Quadros do Azure

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 importar dados no Power BI, juntamente com outras consultas de exemplo.
  • Uma seção sobre como transformar dados no Power BI – Etapas para transformar os dados em um formato reportável expandindo colunas ou alterando tipos de dados de coluna
  • Criar o relatório – Etapas para criar um relatório básico com base nos dados
Categoria Requisitos
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 Analytics e criar visualizações. Para obter mais informações sobre outros pré-requisitos relacionados à ativação de serviços e recursos e atividades gerais de rastreamento de dados, consulte Permissões e pré-requisitos para acessar o Analytics.

Executar uma consulta do Power BI

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

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

    Captura de tela de um relatório em branco no Power BI Desktop. No ribbon da interface, Obter dados está expandido. Obter dados e Consulta em Branco estão realçadas.

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

    Captura de tela do Editor do Power Query do Power BI. Na faixa de opções, no grupo Consulta, o Editor Avançado está realçado.

    A janela Editor Avançado é aberta.

    Captura de tela da janela Editor Avançado no Power BI. Um campo populado esparsamente está disponível para edição de 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 tela da janela do Editor Avançado no Power BI. O campo de consulta contém uma consulta sobre bugs. A sintaxe da consulta inclui espaços reservados.

  4. Substitua todas as cadeias de caracteres de espaço reservado na consulta por seus valores:

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

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

    • {areapath} - Seu caminho de á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 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 tela da janela 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. Esse método fornece 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 gravar consultas OData em dados do Analytics, consulte Relatórios de exemplo e índice de referência rápida.

Conteúdo relacionado

  • Last updated on