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

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

Para extrair dados para o Power BI, recomendamos que você use consultas OData (Open Data Protocol). O OData é um padrão OASIS aprovado pela ISO/IEC que define as melhores práticas para criar e consumir APIs REST. Para obter mais informações, consulte a documentação do OData.

Para começar rapidamente, confira Visão geral de relatórios de exemplo que usam consultas OData. Para obter informações sobre outras abordagens, consulte a visão geral da 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. Com a pré-agregação, você pode realizar agregações em grandes conjuntos de dados, sem a necessidade de extrair todos os dados detalhados para o Power BI.

Neste artigo, vai aprender a:

• Escreva e teste consultas OData.
• Execute uma consulta OData a partir do Power BI.

Pré-requisitos

• Para visualizar dados do Google Analytics e consultar o serviço, você precisa ser membro de um projeto com acesso Básico ou superior. Por padrão, todos os membros do projeto recebem permissões para consultar o Google Analytics e definir exibições do Google Analytics.
• Para saber mais sobre outros pré-requisitos relacionados à ativação de serviços e recursos e atividades gerais de controle de dados, consulte Permissões e pré-requisitos para acessar o Google Analytics.

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-o.

3. Crie e salve um arquivo OData no Visual Studio Code, por exemplo, filename.odata. Nomeie-o como quiser, mas ele deve ter uma .odata extensão para habilitar a funcionalidade de extensão OData.

Escrever a consulta OData

1. Escreva a consulta OData. Para consultas de exemplo, consulte Visão geral de relatórios de exemplo que usam consultas OData.

   A consulta a seguir retorna os 10 principais itens de trabalho em um caminho de área específico.

2. Substitua {organization}, {project}, e {area path} pelos 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 Referência rápida da consulta OData.

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 todos os comandos OData.

   

3. Selecione OData: Abrir. Esta ação combina a consulta de várias linhas num URL de uma linha e abre-a no seu browser predefinido.

   • O conjunto de resultados da consulta OData está no formato JSON. Para visualizar os resultados, instale a extensão JSON Formatter para o 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, esse erro indica que a consulta selecionou 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 do Power BI, siga as etapas na próxima seção.

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. A maneira mais simples de fazer isso é usar o Visual Studio Code com a extensão OData e usar o comando OData: Combinar .

Nota

No arquivo filename.odata , talvez você queira primeiro criar uma cópia do texto da consulta de várias linhas e, em seguida, executar OData: Combine na cópia. Faça esta etapa primeiro porque não há como converter a consulta de linha única de volta em uma consulta multilinha legível.

1. No Visual Studio Code, coloque sua consulta em qualquer lugar no texto da consulta e selecione Exibir>paleta de comando. 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.

   

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

Executar a consulta a partir do Power BI

1. Selecione Obter feed OData de dados>. 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. Selecione Editar na página de pré-visualização para abrir o Power Query Editor.

   

2. Selecione Editor Avançado na faixa de opções.

   

3. Role horizontalmente para exibir o [Implementation="2.0"] parâmetro no painel Consulta .

   

4. Substitua [Implementation="2.0"] pela seguinte cadeia de caracteres:

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

   

   Nota

   Para evitar erros de limitação, execute as seguintes ações:

   • Instrua o Power BI para fazer referência ao OData v4.
   • Instrua 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. Essa ação pode resultar em milhares de consultas, que excedem rapidamente seu limite de uso, além do qual sua conta de usuário é limitada.

   A ação a seguir é necessária para que o Power BI execute com êxito uma consulta OData no Serviço de Análise de DevOps do Azure.

5. Selecione OK 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 faria normalmente no Power BI.

Artigos relacionados

• Exemplos de relatórios do Power BI usando consultas OData
• Dados disponíveis do Google Analytics
• Conceder permissões de acesso ao Google Analytics
• Visão geral da integração do Power BI