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

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

Para extrair dados para o Power BI, recomendamos que você use consultas OData (Open Data Protocol). OData é um padrão estabelecido pela Organização para o Avanço dos Padrões de Informação Estruturada (OASIS) e aprovado pela Organização Internacional de Normalizaçã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 de 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 filtrados ou agregados para o Power BI. As consultas OData têm duas vantagens:

• Toda a filtragem é feita no lado do servidor. Apenas os dados de que você precisa são retornados, o que leva a tempos de atualização mais curtos.
• Você pode pré-agregar dados do lado do servidor. Uma consulta OData pode realizar agregações, como acúmulo de itens de trabalho e taxas de falha de compilação. 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 extrair todos os dados detalhados para o 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 OData é usar o Visual Studio Code com a extensão OData. Visual Studio Code é um editor de código gratuito disponível no Windows, Mac e Linux. A extensão OData fornece realce de sintaxe e outras funções que são úteis para escrever e testar consultas.

Instalar o Visual Studio Code e a extensão OData

1. Instalar o Visual Studio Code.

2. Abra o Visual Studio Code, selecione Extensões e procure odata. Na lista de resultados, selecione vscode-odata e instale esta 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 quiser, por exemplo, filename.odata. Mas ele deve ter uma extensão .odata para habilitar a funcionalidade de extensão OData.

Escrever a consulta OData

Escreva a consulta OData. Para consultas de 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} por 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} completamente.

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ê verá o realce da 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, digite odata para exibir 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 visualizar os resultados, instale uma extensão de formatador JSON para seu navegador. Estão disponíveis várias opções para o Chrome e o Microsoft Edge.

     

   • Se a consulta tiver um erro, o serviço 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 a partir do Power BI.

Executar a consulta OData a partir do Power BI

Para executar a consulta OData a partir do Power BI, siga os passos nas secções seguintes.

Combine 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: Combine para essa finalidade, execute as seguintes etapas:

1. Faça uma cópia do arquivo OData que contém o texto da consulta de várias linhas. Esta etapa é recomendada, porque 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 a partir do Power BI

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

   

2. Na janela de 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 pré-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 cadeia de caracteres:

   [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 Analytics a omitir quaisquer valores que sejam nulos, o que melhora o desempenho da consulta.

   O Power Query tenta resolver valores nulos como erros gerando outra consulta para cada valor nulo encontrado. Esta 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 Power BI Power Query Editor. Pode utilizar 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 deteta 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 & Aplicar para salvar suas configurações e extrair os dados para o Power BI. Após as atualizações de dados, você pode criar um relatório como normalmente faz no Power BI.

Conteúdo relacionado

• Dados disponíveis do Analytics
• Definir permissões para aceder às vistas do Analytics e do Analytics
• Sobre a integração do Power BI