Conectar-se com dados usando consultas do Power BI e OData

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

Para extrair dados para o Power BI, recomendamos que você use consultas OData (Open Data Protocol). O OData é um padrão estabelecido pela Organização para o Avanço dos Padrões de Informações Estruturadas (OASIS) e aprovado pela Organização Internacional para a Padronização e pela Comissão Eletrotécnica Internacional (ISO/IEC). O OData define as práticas recomendadas para criar e consumir APIs REST. Para obter mais informações, consulte a documentação do OData.

Para começar rapidamente, consulte Visão geral dos relatórios de exemplo usando consultas OData. Para obter informações sobre outras abordagens, consulte Sobre a integração do Power BI.

O Power BI pode executar consultas OData, que podem retornar um conjunto de dados filtrado ou agregado para o Power BI. As consultas OData têm duas vantagens:

• Toda a filtragem é feita no lado do servidor. Somente os dados necessários são retornados, o que leva a tempos de atualização mais curtos.
• Você pode pré-agregar dados no lado do servidor. Uma consulta OData pode realizar agregações, como rollup de item de trabalho e taxas de falhas em construções. As agregações são realizadas no lado do servidor e somente os valores agregados são retornados ao Power BI. Usando a pré-agregação, você pode realizar agregações em grandes conjuntos de dados sem precisar efetuar pull de todos os dados detalhados no Power BI.

Neste tutorial, você:

Pré-requisitos

Usar o Visual Studio Code para escrever e testar consultas OData

A maneira mais fácil de escrever e testar o OData é usar o Visual Studio Code com a extensão OData. O Visual Studio Code é um editor de código gratuito disponível para Windows, Mac e Linux. A extensão OData fornece realce de sintaxe e outras funções úteis para escrever e testar consultas.

Instalar o Visual Studio Code e a extensão OData

1. Instale o Visual Studio Code.

2. Abra o Visual Studio Code, selecione Extensões e pesquise odata. Na lista de resultados, selecione vscode-odata e instale essa extensão.

3. No Visual Studio Code, crie um arquivo OData criando um arquivo vazio que tenha a extensão .odata. Você pode nomeá-lo como desejar, por exemplo, filename.odata. Mas ele deve ter uma extensão .odata para habilitar a funcionalidade de extensão OData.

Escreva a consulta OData

Escreva a consulta OData. Por exemplo, consulte Visão geral de relatórios de exemplo usando consultas OData.

A consulta a seguir retorna os 10 principais itens de trabalho em um caminho de área específico. Para usar essa consulta, substitua {organization}{project}e {area path} com seus valores.

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
      $select=WorkItemId,Title,WorkItemType,State,CreatedDate
      &$filter=startswith(Area/AreaPath,'{area path}')
      &$orderby=CreatedDate desc
      &$top=10

Para consultar entre projetos, omita /{project} totalmente.

Para obter mais informações, consulte Relatórios de exemplo e índice de referência rápida.

Depois de escrever a consulta no Visual Studio Code, você deverá ver o realce de sintaxe.

Testar a consulta OData

1. Para testar a consulta OData, coloque o cursor em qualquer lugar no texto da consulta e selecione Exibir>Paleta de Comandos.

2. Na caixa de pesquisa, insira odata para abrir os comandos OData.

   

3. Selecione OData: Abrir. Essa ação combina a consulta de várias linhas em uma URL de uma linha, executa a consulta e abre os resultados no navegador padrão.

   • O conjunto de resultados da consulta OData está no formato JSON. Para exibir os resultados, instale uma extensão de formatador JSON para seu navegador. Várias opções estão disponíveis para Chrome e Microsoft Edge.

     

   • Se a consulta tiver um erro, o serviço do Analytics retornará um erro no formato JSON. Por exemplo, o erro a seguir indica que a consulta seleciona um campo que não existe.

     

Depois de verificar se a consulta funciona corretamente, você pode executá-la no Power BI.

Executar a consulta OData do Power BI

Para executar a consulta OData do Power BI, execute as etapas nas seções a seguir.

Combinar a consulta OData de várias linhas em uma consulta de linha única

Antes de usar a consulta no Power BI, você deve converter a consulta OData de várias linhas em uma consulta de linha única. Para usar o comando OData: Combinar para essa finalidade, execute as seguintes etapas:

1. Faça uma cópia do arquivo OData que contém o texto de consulta de várias linhas. Essa etapa é recomendada, pois não há como converter a consulta de linha única de volta em uma consulta multilinha legível.

2. No Visual Studio Code, abra a cópia do arquivo OData e coloque o cursor em qualquer lugar no texto da consulta.

3. Selecione Exibir>Paleta de Comandos. Na caixa de pesquisa, digite odata. Em seguida, na lista de resultados, selecione OData: Combinar.

   A consulta de várias linhas é convertida em uma consulta de linha única.

   

4. Copie a linha inteira para uso na próxima seção.

Executar a consulta no Power BI

1. No Power BI, selecione Obter dados>OData. Para obter mais informações, consulte Criar um relatório do Power BI com uma consulta OData.

   

2. Na janela do feed OData, na caixa URL, cole a consulta OData que você copiou na seção anterior e selecione OK.

   

   O Power BI exibe uma página de visualização.

   

Especificar opções de consulta

1. Na página de visualização, selecione Transformar Dados para abrir o Editor do Power Query.

   

2. Na faixa de opções, selecione Editor Avançado.

   

3. Na janela Editor Avançado, role horizontalmente para exibir o [Implementation="2.0"] parâmetro na consulta.

   

4. Substitua [Implementation="2.0"] pela seguinte string:

   [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]

   

   Essa alteração ajuda a evitar erros de limitação. Os novos valores têm o seguinte efeito:

   • Eles instruem o Power BI a fazer referência ao OData versão 4.
   • Eles instruem o serviço de Análise a omitir todos os valores que são nulos, o que melhora o desempenho da consulta.

   Power Query tenta resolver valores nulos como erros gerando outra consulta para cada valor nulo encontrado. Essa ação pode resultar em milhares de consultas. Essas consultas podem exceder rapidamente seu limite de uso, além do qual sua conta de usuário é limitada.

5. Selecione Concluído para fechar o Editor Avançado e retornar ao Editor do Power BI Power Query. Você pode usar o Editor do Power Query para executar as seguintes ações opcionais:

   • Renomeie a Query1 consulta como algo mais específico.
   • Transforme colunas em um tipo específico. O Power BI detecta automaticamente o tipo, mas talvez você queira converter colunas em um tipo de dados específico.
   • Adicione colunas computadas.
   • Remover colunas.
   • Expanda colunas em campos específicos.

Criar um relatório usando os dados

Selecione Fechar e Aplicar para salvar suas configurações e extrair os dados para o Power BI. Depois que os dados forem atualizados, você poderá criar um relatório como normalmente faz no Power BI.

Conteúdo relacionado

• Dados disponíveis no Analytics
• Definir permissões para acessar o Analytics e as visualizações do Analytics
• Sobre a integração do Power BI