Conectar o Google Analytics ao Power BI Data Connector

  • Artigo

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

Neste artigo, saiba como estabelecer uma conexão perfeita entre o Power BI e o Azure DevOps usando o Data Connector. Essa integração permite extrair informações valiosas de seus dados de DevOps do Azure e criar relatórios atraentes no Power BI. O Power BI Data Connector usa modos de exibição do Google Analytics.

Importante

As vistas do Analytics suportam apenas dados dos Painéis do Azure (itens de trabalho). As visualizações do Google Analytics não oferecem suporte a outros tipos de dados, como pipelines. Os modos de exibição fornecem uma lista plana de itens de trabalho e não oferecem suporte a hierarquias de itens de trabalho. Neste ponto, não temos planos de atualizar o conector para suportar outros tipos de dados. Para obter informações sobre outras abordagens, consulte Sobre a integração do Power BI.

Pré-requisitos

  • Familiarize-se com O que é o Google Analytics e a base de dados de conhecimento dos artigos do Power BI.
  • Instale a Atualização de outubro de 2018 do Power BI Desktop ou uma versão mais recente.
  • Certifique-se de que é membro de um projeto com acesso Básico ou superior. Se você ainda não tem um projeto, crie um.
  • Certifique-se de que é membro do projeto. Se não estiver, seja adicionado agora. Qualquer pessoa com acesso ao projeto, exceto as partes interessadas, pode visualizar as visualizações do Google Analytics.
  • Verifique se o Google Analytics está instalado e, se não, ative-o. Você deve ser um proprietário de conta ou um membro do grupo Administradores da Coleção de Projetos para adicionar extensões ou habilitar o serviço.
  • Certifique-se de que o Boards está ativado. Caso contrário, as visualizações do Google Analytics não serão exibidas. Para reativar painéis, consulte Ativar ou desativar um serviço de DevOps do Azure.
  • Verifique se você tem as permissões necessárias para acessar o Google Analytics. Se você for membro do grupo de Colaboradores do projeto, terá permissão.
  • Crie uma vista do Analytics para a qual pretende criar um relatório do Power BI.

Importante

O Azure DevOps não dá suporte à autenticação de Credenciais Alternativas. Se você ainda estiver usando Credenciais Alternativas, recomendamos que mude para um método de autenticação mais seguro.

Conectar-se a uma visualização do Google Analytics

  1. Abra Power BI Desktop.

  2. Inicie sessão no serviço. O acesso pela primeira vez requer que inicie sessão e tenha as suas credenciais autenticadas. O Power BI Desktop salva suas credenciais para que você só precise fazer isso uma vez.

    Nota

    O Azure DevOps não oferece suporte a cenários entre locatários usando OAuth. Em vez disso, use entidades de serviço e identidades gerenciadas.

  3. Selecione Conectar após a verificação de suas credenciais.

    Captura de ecrã que mostra a caixa de diálogo Ligação do Power BI.

  4. Selecione Obter Serviços de Dados>Online e, em seguida, selecione Azure DevOps (somente Painéis) para serviços de nuvem ou selecione Servidor de DevOps do Azure (somente Painéis) para local. Selecione Ligar. As visualizações do Google Analytics suportam apenas consultas em itens de trabalho e casos de teste.

    Captura de tela que mostra o fluxo Obter Dados.

  5. Especifique os parâmetros básicos para se conectar aos seus dados.

    Captura de tela que mostra a especificação da organização e do nome do projeto.

    Captura de tela que mostra a especificação da organização e do nome do projeto, versão local.

    • URL de Coleta: insira a URL onde sua instância do Servidor de DevOps do Azure está hospedada. Um exemplo de URL é http://fabrikam-server/AzureDevOpsServer/fabrikam-collection.
    • Projeto de equipe: insira apenas o nome do projeto. Por exemplo, use Fabrikam-Fiber se a URL da sua instância do Azure DevOps Server for http://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber.

    Importante

    Não confunda o nome da equipe com o nome do projeto, que é um erro comum. Por exemplo, se a URL que você usa for http://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber-Git/Device, Fabrikam-Fiber-Git é o nome do projeto e Device é o nome da equipe.

    Após a entrada bem-sucedida, o Power BI verifica se suas credenciais de usuário têm permissões para acessar o projeto especificado. Se surgirem erros, consulte as Perguntas frequentes para obter soluções para os problemas mais comuns.

Selecione a visualização do Google Analytics

  1. Expanda a pasta Vistas Partilhadas , selecione uma vista do Analytics e, em seguida, selecione Carregar. O Conector de Dados apresenta uma lista de visualizações disponíveis do Google Analytics. Cada modo de exibição representa um conjunto de dados que você pode extrair para o Power BI. Também pode criar vistas personalizadas do Analytics.

    A imagem a seguir mostra as visualizações padrão do Google Analytics. Sua lista de exibições pode diferir com base no modelo de processo usado para criar seu projeto. Todos os modos de exibição listados, exceto os modos de exibição anexados com "Hoje", fornecem dados de tendências históricas.

    No exemplo a seguir, selecionamos Histórias - Últimos 30 dias, que filtra os itens da lista de pendências do produto.

    Captura de ecrã que mostra a caixa de diálogo Navegador com a vista Escolher uma análise.

    Nota

    Como você verificou o modo de exibição na seção anterior, o modo de exibição deve ser carregado. Se a exibição não carregar, é mais provável que seja porque o conjunto de dados é muito grande. Regresse à vista na vista do Analytics no portal Web e ajuste os filtros para diminuir o tamanho do conjunto de dados.

  2. Selecione a vista.

    Captura de ecrã que mostra a caixa de diálogo Navegador com vistas predefinidas.

    Nota

    A pré-visualização apresentada para quaisquer vistas selecionadas no navegador pode ser truncada dependendo do número de campos selecionados e do tamanho do conjunto de dados. Os dados são truncados apenas para a visualização e não afetarão a atualização completa dos dados.

    • Selecione a tabela Itens de Trabalho - Hoje e aguarde o carregamento da visualização. Ele representa o estado atual de todos os itens de trabalho no projeto.
    • Marque a caixa de seleção ao lado da tabela Itens de Trabalho - Hoje e selecione Carregar.

    Nota

    As exibições do Google Analytics não aplicam filtros definidos usando o Power BI no servidor. Todos os filtros aplicados no Power BI limitam os dados mostrados aos usuários finais, mas não reduzem a quantidade de dados recuperados do Google Analytics. Se o filtro se destinar a reduzir o tamanho do conjunto de dados, aplique-o personalizando a exibição.

  3. Aguarde até que os dados sejam carregados. Você pode observar seu progresso observando as mensagens de status, que aparecem diretamente sob o nome da tabela. Se vir algum erro, consulte a secção Perguntas frequentes para obter soluções para os problemas mais comuns.

    Captura de tela que mostra a caixa de diálogo Aplicar alterações de consulta.

  4. Analise o modelo de dados. Enquanto o modelo é carregado, revise o design do conjunto de dados para o Power BI Data Connector.

Criar um relatório

Crie um relatório com base nos dados carregados. Após a conclusão da operação de carregamento, você pode explorar os dados criando relatórios personalizados. Para obter exemplos de relatórios comuns, consulte Data Connector - Exemplos de relatórios.

Captura de ecrã que mostra a vista de relatório do Power BI Desktop.

FAQs

Encontre respostas para perguntas comuns sobre o Power BI Data Connector e mensagens de erro do Analytics.

P: Como devo ler as mensagens de erro provenientes do conector?

R: Você pode se sentir desafiado a ler mensagens de erro provenientes do conector porque elas geralmente contêm informações contextuais extras. Se a operação de carregamento falhar, a mensagem começa com "Falha ao salvar modificações no servidor...". Quando você vê-lo, procure por [DataSource.Error] Azure DevOps...:. O exemplo a seguir mostra a mensagem de erro retornada do conector. A parte mais importante da mensagem de erro é "O resultado da consulta excede o tamanho máximo. Reduza o número de registros aplicando filtros adicionais."

Captura de tela que mostra a mensagem de erro Consulta excede o tamanho máximo.

P: Como resolvo o "O resultado da consulta excede o tamanho máximo. Reduzir o número de registros aplicando filtros adicionais" erro?

R: Você receberá o seguinte erro se o número de registros recuperados do Google Analytics exceder 250.000:

"Falha ao salvar modificações no servidor. Erro retornado: 'Erro OLE DB ou ODBC: [DataSource.Error] VSTS: Falha na solicitação: O servidor remoto retornou um erro: (400) Solicitação incorreta. (O resultado da consulta excede o tamanho máximo. Reduza o número de registros aplicando filtros adicionais).'"

Este erro normalmente ocorre quando seu projeto tem um grande número de itens de trabalho. Reduza o tamanho do conjunto de dados personalizando a exibição. Faça esta etapa antes de usá-lo no Power BI.

Captura de tela que mostra o resultado da consulta excede o erro de tamanho máximo.

P: Como resolvo o erro "o utilizador não foi autorizado"?

R: Poderá obter este erro se tentar aceder a um projeto para o qual não tem permissões. Você também pode vê-lo se o Power BI não reconhecer suas credenciais. Para verificar suas permissões, consulte Definir permissões para acessar as visualizações do Google Analytics e do Google Analytics. Se for um problema de credencial, trabalhe com o administrador para ver se ele pode ajudar a resolver o problema. Para obter mais informações, consulte Segurança do Power BI, autenticação de usuário e Solução de problemas de entrada para o Power BI.

Captura de tela que mostra o erro de acesso negado.

Nota

O Power BI usa a ID do Microsoft Entra para autenticar usuários que entram no serviço do Power BI e, por sua vez, usa as credenciais de entrada do Power BI sempre que um usuário tenta acessar recursos que exigem autenticação. Os usuários entram no serviço do Power BI usando o endereço de email usado para estabelecer sua conta do Power BI. O Power BI usa esse email de entrada como o nome de usuário efetivo, que é passado para os recursos sempre que um usuário tenta se conectar aos dados. O nome de usuário efetivo é então mapeado para um nome principal de usuário e resolvido para a conta de domínio do Windows associada, contra a qual a autenticação é aplicada.

P: Como resolvo o erro "O acesso ao recurso é proibido"?

R: Você pode receber esse erro se tiver acesso a um projeto específico, mas não tiver as permissões de análise de exibição. Trabalhe com o administrador do projeto para obter essas permissões. Para obter mais informações sobre o modelo de segurança, consulte Segurança do Google Analytics.

Captura de ecrã que mostra a mensagem de erro O acesso ao recurso é proibido.

P: Como resolvo o erro "O projeto 'X' não existe ou você não tem permissões para acessá-lo"?

R: Este erro indica que o valor que introduziu para o nome do projeto não corresponde a nenhum projeto. Um erro comum que os usuários cometem é confundir o nome do projeto com um nome de equipe.

Por exemplo, se a URL usada for https://dev.azure.com/fabrikam-fiber-inc/Fabrikam-Fiber-Git/Device, Fabrikam-Fiber-Git é o nome do projeto e deve ser usado no parâmetro. Device é o nome da equipa.

Captura de tela que mostra o erro Projeto não encontrado.

Conteúdos relacionados