Conector do Looker para o Power BI

Com o conector Looker–Power BI, é possível usar o Microsoft Power BI Desktop para se conectar aos dados de uma Análise do Looker.

Como configurar o Power BI Desktop para se conectar ao Looker

As etapas gerais para usar o conector do Looker para Power BI são as seguintes:

  1. Verifique os requisitos.
  2. Ative o conector na sua instância do Looker.
  3. Faça o download e salve o arquivo do conector: cada usuário que quiser acessar o conector do Looker para o Power BI precisa baixar o arquivo looker_1.4.3.mez e salvar em um diretório específico no computador.
  4. Configurar o Power BI Desktop para um conector personalizado: cada usuário do Power BI precisa configurar as definições de segurança do Power BI Desktop para usar um conector personalizado não certificado.

As seções nesta página descrevem essas etapas em detalhes.

Depois de concluir as etapas para conectar o Looker ao Power BI Desktop, você poderá conectar-se aos dados do Looker no Power BI e publicar relatórios no Power BI. Se quiser, use o serviço do Power BI (Power BI on-line) para interagir com seus relatórios do Looker em um navegador da Web. Também é possível publicar relatórios com o serviço do Power BI usando a segurança no nível da linha.

Requisitos

Para configurar o conector do Looker para o Power BI, você precisa do seguinte:

  • O Microsoft Power BI Desktop instalado no seu computador.
  • Uma instância do Looker que atenda aos seguintes requisitos:
    • A instância precisa ser hospedada pelo Looker. As instâncias do Looker (Google Cloud Core) são hospedadas pelo Looker e compatíveis com o conector Looker–Power BI.
    • A instância precisa estar executando o Looker 23.10 ou uma versão mais recente.
  • Uma conta de usuário do Looker na instância do Looker com a permissão explore, necessária para acessar as Análises no Looker. Se você quiser trabalhar com consultas com mais de 5.000 linhas, também precisará da permissão download_without_limit. Consulte Limites de linhas de consulta para informações sobre limites de download.

Ativar o conector na instância do Looker

A instância do Looker que você quer usar com o conector Looker–Power BI precisa estar ativada para o conector Microsoft Power BI:

  • Para instâncias do Looker (Google Cloud Core), os conectores de BI são ativados por padrão.
  • Para instâncias do Looker (original), os conectores de BI ficam desativados por padrão.

O administrador do Looker pode ativar os conectores de BI no painel "Conectores de BI" na seção Plataforma do menu Administrador do Looker.

Baixar e salvar o arquivo do conector

Para fazer o download do arquivo do conector, siga estas etapas no computador com o Microsoft Power BI Desktop instalado:

  1. Para fazer o download do arquivo do conector, clique no link a seguir: looker_1.4.3.mez
  2. Quando o download for concluído, mova o arquivo looker_1.4.3.mez para o diretório [Documentos]\Microsoft Power BI Desktop\Conectores personalizados. Crie as pastas no seu computador se elas ainda não existirem.

Como configurar o Power BI Desktop para um conector personalizado

Para configurar o conector do Looker–Power BI no Power BI Desktop, siga as instruções de Conectores personalizados no site do Microsoft Power BI.

Como diz nas instruções, em Extensões de dados, selecione a opção (Não recomendado) Permitir que qualquer extensão seja carregada sem validação ou aviso. Selecione OK e reinicie o Power BI Desktop.

Conectar aos dados do Looker no Power BI Desktop

Depois de baixar o looker_1.4.3.mez arquivo do conector e configurar o aplicativo Power BI Desktop para um conector personalizado, use o Power BI Desktop para se conectar aos dados da sua instância do Looker:

  1. Na barra de ferramentas do Power BI Desktop, selecione Obter dados > Mais...
  2. Na caixa de diálogo Extrair dados, digite Looker no campo de pesquisa.
  3. Nos resultados da pesquisa, clique na entrada Looker e em Conectar.
  4. Na caixa de diálogo Conectar a um serviço de terceiros, clique em Continuar.
  5. O Power BI Desktop vai mostrar uma caixa de diálogo de login do Looker. No campo Host, digite o URL da sua instância. Por exemplo, example.cloud.looker.com.

  6. Opcionalmente, clique em Opções avançadas para abrir a seção e configurar as seguintes opções adicionais:

    • Use o menu suspenso Mostrar análises e campos ocultos para incluir análises e campos configurados como ocultos na LookML. Para mais informações, consulte a documentação sobre oculto (para análises) e oculto (para campos):
      • FALSE (padrão): os campos ocultos são suprimidos.
      • TRUE: os campos ocultos são mostrados.
    • Use o menu suspenso Ativar geração de registros para ativar os registros de diagnóstico no conector e resolver problemas:
      • FALSE (padrão): os registros de diagnóstico são desativados.
      • TRUE: os registros de diagnóstico estão ativados.

  7. Selecione a opção DirectQuery para criar uma conexão direta com seus dados no Looker.

  8. Clique em OK.

  9. Na caixa de diálogo Looker, clique em Fazer login.

  10. Na tela de login do Looker, faça login na sua instância do Looker.

  11. O Power BI Desktop vai voltar para a caixa de diálogo de login do Looker com uma mensagem informando que você fez login. Clique em Conectar.

  12. O Power BI Desktop vai mostrar uma lista dos modelos do Looker a que você tem acesso, cada um representado como uma pasta. Clique no modelo do Looker que você quer acessar e marque a caixa de seleção ao lado da Análise do Looker que você quer carregar no Power BI Desktop. Para ver um modelo, você precisa ter acesso de usuário ou de grupo do Looker a um conjunto de modelos que o contenha. Para acessar as análises detalhadas, você precisa ter a permissão explore do Looker.

  13. Clique em Carregar.

O Power BI Desktop vai preencher o painel Dados com os campos da Análise selecionada. Em seguida, use os dados do Looker da Análise para criar relatórios no Power BI Desktop. Consulte Como visualizar elementos do Looker no Power BI Desktop para saber como o conector Looker–Power BI mostra os elementos do Looker.

Os nomes dos campos vão aparecer em uma única lista no formato ViewName.FieldName.

Como ver elementos do Looker no Power BI Desktop

Depois de conectar os dados do Looker ao Power BI Desktop, o Power BI Desktop vai preencher o painel Dados com os campos da Análise selecionada.

O conector do Looker para o Power BI usa o seguinte formato para mostrar os campos do Looker no Power BI Desktop:

ViewName.FieldType.FieldName

  • O valor ViewName é a visualização do LookML em que o campo é definido.

  • O valor FieldType pode ser um dos seguintes tipos compatíveis com o conector do Looker para o Power BI:

    • dim: dimensão, um campo que representa um atributo, um fato ou um valor, como datas, nomes e IDs. As dimensões geralmente correspondem a colunas na tabela de dados subjacente. No LookML, as dimensões são definidas com o parâmetro dimension.
    • mea: medida, um campo que representa informações mensuráveis sobre seus dados, como somas, contagens, médias, mínimos e máximos. Em LookML, as medidas são definidas com o parâmetro measure.
    • fil: filtro, um campo somente para filtros usado apenas para criar um filtro em uma consulta de Análise. Os campos de filtro não são incluídos no conjunto de resultados de uma consulta. Na LookML, os filtros são definidos com o parâmetro filter.
    • par: parâmetro, um campo usado apenas para criar um filtro em uma consulta de análise. Os campos de parâmetro não são incluídos no conjunto de resultados de uma consulta. Um parâmetro pode criar resultados de consultas interativas, rótulos, URLs e muito mais quando é definido com as variáveis {% parameter parameter_name %} e parameter_name._parameter_value do Liquid. Em LookML, os parâmetros são definidos com o parâmetro parameter.

  • O valor FieldName é o nome do campo como aparece na Análise detalhada do Looker.

O Power BI Desktop mostra os elementos do Looker da mesma forma que aparecem no Looker Explore, com a mesma capitalização e espaçamento entre palavras. Por exemplo, se uma Análise do Looker mostrar uma dimensão do LookML como Created Date de uma visualização exibida como Order Items, o Power BI Desktop vai mostrar esse campo como Order Items.dim.Created Date.

Como criar consultas com dimensões e medidas do Looker

Com o conector Looker–Power BI, é possível usar dimensões e medidas do Looker para criar consultas no Power BI Desktop.

Para criar uma consulta no Power BI Desktop usando dimensões e métricas do Looker, siga estas etapas:

  1. Conecte-se aos dados do Looker no Power BI Desktop e aguarde o Power BI preencher o painel Dados com os campos da análise detalhada do Looker selecionada.
  2. No painel Dados do Power BI, marque a caixa de seleção de cada dimensão ou métrica do Looker que você quer incluir na consulta.

À medida que você seleciona cada dimensão ou métrica, o Power BI atualiza a consulta mostrada na tela do relatório.

Filtrar consultas com filtros e parâmetros do Looker

Com o conector Looker–Power BI, é possível usar parâmetros e campos somente para filtros da LookML em uma Análise do Looker para adicionar filtros ao seu relatório do Power BI.

Para filtrar um relatório no Power BI Desktop usando parâmetros do Looker e campos somente para filtro, siga estas etapas:

  1. Se ainda não fez isso, conecte-se aos dados do Looker no Power BI Desktop e aguarde até que o Power BI preencha o painel Dados com os campos da Análise do Looker selecionada.

  2. No painel Dados do Power BI, arraste o nome de um parâmetro ou um campo somente para filtros para uma das caixas Adicionar campos de dados aqui no painel Filtros, seja para Filtros nesta página ou para Filtros em todas as páginas. Consulte a documentação do Power BI para saber como adicionar filtros a um relatório no Power BI.

Observações sobre o uso de parâmetros do Looker e campos somente para filtros no Power BI:

  • Para campos somente para filtro configurados no LookML com o parâmetro suggestions ou suggest_dimension, o Power BI vai buscar os valores de sugestão e mostrá-los nas opções de Filtragem básica no painel Filtros.

  • Para parâmetros configurados em LookML com o atributo allowed_value, o Power BI vai buscar todos os valores permitidos configurados em LookML para o parâmetro e os mostrará nas opções de Filtragem básica no painel Filtros.

Como monitorar o conector do Looker e do Power BI

Um administrador do Looker pode conferir o uso do conector do Looker para Power BI usando o grupo de campos Propriedades do cliente da API de consulta na Análise do histórico de atividade do sistema. Uma entrada é criada no Histórico do recurso Detalhar sempre que uma nova consulta é executada.

No grupo de campos Consultar propriedades do cliente da API, o Nome do cliente da API mostra um valor Power BI para identificar entradas do conector do Looker com o Power BI.

Confira um exemplo de URL de atividade do sistema que mostra o uso do Power BI. Substitua <instance_name.looker.com> pelo URL da instância.

https://<instance_name.looker.com>/explore/system__activity/history?fields=query_api_client_context.name,user.name,history.created_date,history.created_time_of_day&f[query_api_client_context.name]=Power+BI&sorts=history.created_time_of_day+desc&limit=5000

Serviço do Power BI

Depois de conectar os dados do Looker ao Power BI e publicar relatórios no Power BI, você pode usar o serviço do Power BI (Power BI on-line) para interagir com seus relatórios do Looker em um navegador da Web.

Também é possível publicar relatórios com o serviço do Power BI usando a segurança no nível da linha.

Publicar um relatório com o serviço do Power BI usando a segurança no nível da linha

Depois de publicar relatórios no Power BI Desktop usando o conector Looker–Power BI, você pode usar o serviço do Power BI para interagir com os relatórios em um navegador da Web.

Com o Power BI Desktop, é possível usar a segurança no nível da linha (RLS) para restringir o acesso aos dados de determinados usuários. Consulte a documentação do Power BI para ver os procedimentos de definição de papéis e regras e validação dos papéis no Power BI Desktop.

Depois de definir as funções no Power BI Desktop, você pode usar as funções e regras on-line com o serviço do Power BI.

Para publicar um relatório com o serviço do Power BI usando segurança em nível de linha, siga estas etapas:

  1. No Power BI Desktop, abra o relatório e selecione o menu Página inicial na parte de cima da janela.
  2. Selecione a opção Publicar no menu Página inicial.
  3. Selecione um espaço de trabalho no menu suspenso e clique em Selecionar. O Power BI Desktop mostra uma mensagem de confirmação que inclui um link para abrir o relatório no Power BI.
  4. Clique no link para abrir o Power BI.
  5. No serviço do Power BI, acesse Espaços de trabalho e selecione o espaço em que você publicou o relatório.
  6. Encontre a página do conjunto de dados do relatório (não o relatório em si).
  7. Na lista de conjuntos de dados, clique no menu de três pontos Mais opções e selecione Segurança.

O Power BI vai mostrar a janela Segurança no nível da linha. Aqui, você pode selecionar a função criada no Power BI Desktop e adicionar pessoas ou grupos que pertencem a ela e validar suas funções no serviço do Power BI.

Agora você pode compartilhar o relatório com quem quiser, e as pessoas vão ver apenas os dados a que têm acesso, com base nas funções que você criou.

Informações importantes

Limites de linhas de consulta

As consultas do conector Looker–Power BI incluem automaticamente uma instrução LIMIT 5000, a menos que a conta de usuário do Looker tenha a permissão download_without_limit. Se a conta de usuário do Looker tiver download_without_limit, as consultas do conector Looker–Power BI não terão um limite de linhas imposto.

Conferir filtros

Se a Análise do Looker for definida com os parâmetros always_filter ou conditionally_filter do LookML, os filtros serão aplicados às consultas no conector do Looker e do Power BI, mesmo que não estejam visíveis no Power BI.

Períodos de tempo aceitos para grupos de dimensões

Para o dimension_group de type: time, somente os períodos date e time são compatíveis com o conector do Looker para o Power BI. Outros períodos serão ocultados.

As análises detalhadas da atividade do sistema não aparecem com o conector do Looker para Power BI

As Análises detalhadas da atividade do sistema não aparecem no conector do Looker para Power BI. Os administradores do Looker podem acessar as análises detalhadas de atividade do sistema diretamente na interface do Looker.

Limitações conhecidas

Confira abaixo as limitações conhecidas do conector do Looker para o Power BI:

  • As dimensões e medidas numéricas são renderizadas como medidas. Consulte Campos de dimensão e medida para uma descrição delas. Para usar uma dimensão numérica como dimensão, primeiro mude para Não resumido no Power BI Desktop.
  • Para garantir o melhor desempenho e funcionalidade, use o modo DirectQuery sempre que possível. Ao usar o modo de importação do Power BI com o conector do Looker para Power BI, observe as seguintes limitações:
    • Os relatórios do modo de importação que tentam acessar modelos maiores podem ter uma queda no desempenho.
    • Se o processo "Receber dados" não for resolvido ou atingir o tempo limite, mude para o modo DirectQuery para melhorar o desempenho e a confiabilidade.
    • Não use campos somente para filtros e parâmetros se estiver usando o modo de importação, já que eles ficam desativados nesse modo.
    • O modo de importação não permite que o Looker avalie corretamente as medidas na análise detalhada. Essa limitação pode afetar a acurácia e a funcionalidade dos seus relatórios.
  • O Power BI tenta aplicar as próprias agregações nas medidas do Looker, o que às vezes leva a resultados inconsistentes (especialmente se você estiver usando visuais de matriz) ou faz com que as agregações não funcionem devido à falta de um mapeamento equivalente.
    • Use apenas os seguintes tipos de medidas compatíveis nos seus relatórios do Power BI: average, count, count-distinct, max, min, sum.
    • Não é possível consultar o desvio padrão e a variância.
    • Não é possível consultar a primeira ou a última string em ordem alfabética usando os agregadores primeiro/último do Power BI.
    • No Power BI, a consulta para a mediana é feita extraindo todos os valores do conjunto de dados e calculando a mediana localmente. Esse processo pode ser muito lento em conjuntos de dados maiores e pode atingir o tempo limite.
  • Devido às inconsistências com o Power Query e as expressões de filtro do Looker, fique atento às seguintes limitações dos filtros avançados:
    • Todos os filtros de texto são compatíveis.
    • Não é possível usar vários filtros de texto.
    • Todos os filtros de número são aceitos.
    • Vários filtros numéricos só são aceitos nos seguintes casos:
      • DESIGUALDADE E DESIGUALDADE (por exemplo, é menor que E é maior que).
      • DESIGUALDADE OU DESIGUALDADE (por exemplo, é menor que OU é maior que).
      • é OU é.
    • Somente os seguintes filtros de data/data e hora são compatíveis: is, is not, is on or after, is before.
    • Vários filtros de data e hora só são aceitos nos seguintes casos:
      • is on or after AND is before
      • is or is
    • As seguintes funções de tabela não podem ser recolhidas:
      • Table.Distinct
      • Table.Join
      • Table.NestedJoin
      • Table.Skip

Registro de alterações do conector Looker–Power BI

As seções a seguir mostram as atualizações em cada versão do conector do Looker para o Power BI:

Versão 1.4.3

A versão 1.4.3 do conector Looker–Power BI tem as seguintes atualizações:

  • O rótulo do conector agora inclui o número da versão.
  • Adicionamos uma nova opção Ativar registro para ativar dinamicamente os registros de diagnóstico no conector para fins de solução de problemas.
  • Adicionamos uma nova opção Mostrar análises detalhadas e campos ocultos. Quando ativada, as análises detalhadas e os campos ocultos são mostrados. Isso substitui a opção anterior Mostrar campos ocultos.

A versão 1.4.3 do conector Looker–Power BI tem as seguintes correções de bugs:

  • Foi corrigido um problema em que o operador DAX de concatenação de strings (&) falhava.
  • Correção do problema em que a aplicação de uma medida do Power BI em uma medida do Looker causava um erro.
  • O menu "Configuração de credenciais" mostra o ícone do Looker novamente.

Versão 1.4.2

Clique para abrir a seção

A versão 1.4.2 do conector Looker–Power BI tem as seguintes atualizações:

  • A configuração de conexão Desativar otimização de visualização foi removida.
  • A opção de conexão Mostrar campos ocultos foi movida para a seção Opções avançadas.
  • A flag Beta foi removida. O conector não aparece mais como Beta no Power BI.

A versão 1.4.2 do conector Looker–Power BI tem as seguintes correções de bugs:

  • Foi corrigido o erro de regressão em que segmentações booleanas e de data falhavam no Power BI.
  • Correção do filtro is-not que não funcionava para o filtro dates.

Versão 1.4.0

Clique para abrir a seção

A versão 1.4.0 do conector do Looker para Power BI tem as seguintes atualizações:

  • Adicionada compatibilidade com o modo de importação
  • Visualização de dados ativada
  • Melhoria no comportamento ao realizar consultas SELECT *
  • Melhoria na taxa de ocorrência em cache do Looker
  • Melhoria no desempenho da recuperação de sugestões de filtro

A versão 1.4.0 do conector do Looker para Power BI tem as seguintes correções de bugs:

  • Correção de um bug em que o Looker não detectava que valores tinham sido transmitidos para campos de filtro e parâmetro.
  • Correção de um bug em que os valores sugeridos de parâmetros às vezes não apareciam nos filtros segmentados.
  • Correção de um bug em que as variáveis Liquid eram ignoradas pelas instruções da LookML
  • Correção de um bug em que os valores de medidas de contagem distinta ficavam inconsistentes nas visualizações de matriz do Power BI.

Versão 1.3.1

Clique para abrir a seção

A versão 1.3.1 do conector Looker–Power BI tem as seguintes atualizações:

  • Adicionada a opção de mostrar campos ocultos

A versão 1.3.1 do conector Looker–Power BI tem a seguinte correção de bug:

  • Correção de um bug em que um elemento visual falhava se um filtro existisse no elemento e no relatório.

Versão 1.3.0

Clique para abrir a seção

A versão 1.3.0 do conector do Looker para o Power BI tem as seguintes atualizações:

  • Formatação simplificada de data/hora
  • Melhoria na detecção de expressões de texto incompatíveis
  • Melhoria no relatório de mensagens de erro

A versão 1.3.0 do conector do Looker para Power BI tem a seguinte correção de bug:

  • Compatibilidade aprimorada com caracteres de escape em valores de filtro

Versão 1.2.0

Clique para abrir a seção

A versão 1.2.0 do conector Looker–Power BI tem as seguintes atualizações:

  • Agora há suporte para parâmetros e campos somente para filtros
  • Suporte a filtros avançados para campos somente para filtros do tipo texto, número, data e data/hora
  • Compatibilidade básica com filtros para campos somente para filtros usando valores sugeridos pelo Looker