Conector de BI do Looker e Tableau

Com o conector de BI do Looker e do Tableau, é possível usar uma Análise do Looker como fonte de dados no Tableau. O conector de BI do Looker–Tableau é criado com base na interface SQL aberta do Looker, que permite o acesso a modelos LookML e análises detalhadas para aplicativos que usam JDBC para se conectar a fontes de dados. Consulte a documentação da Interface Open SQL para mais detalhes.

O conector de BI do Looker para Tableau é compatível com o Tableau Desktop e o Tableau Server, mas não com o Tableau Cloud.

Antes de começar

Sua instância do Looker precisa atender aos seguintes requisitos para usar o conector de BI do Looker e do Tableau:

  • Executar o Looker 24.14 ou mais recente.
  • Ativado para o conector de BI do Tableau Desktop. Um administrador do Looker precisa ativar a opção Tableau Desktop na página Conectores de BI do Looker.
  • Contém um modelo do LookML que usa dados de uma conexão do Google BigQuery:
    • O projeto do LookML precisa incluir um modelo configurado com pelo menos uma conexão do Google BigQuery no campo Conexões permitidas. Consulte a página de documentação Como acessar e editar informações do projeto para saber como configurar um modelo e ver as conexões permitidas para ele.
    • O projeto do LookML precisa ter um arquivo model que especifique uma conexão do BigQuery no parâmetro connection.

Além disso, cada pessoa que usa o conector de BI do Looker–Tableau precisa ter uma conta do Looker com uma função de usuário que inclua a permissão explore no modelo LookML que ela quer acessar no Tableau.

Como configurar o Tableau Desktop para se conectar ao Looker

Depois de atender a todos os requisitos, você pode configurar o Tableau Desktop para se conectar aos dados do Looker.

Cada usuário que quiser acessar o conector de BI do Looker para o Tableau precisa baixar o arquivo avatica-<release_number>-looker.jar e o arquivo do conector do Tableau (TACO) e salvar os arquivos em diretórios específicos no computador. As seções a seguir fornecem instruções para baixar esses arquivos e onde colocá-los no computador:

Arquivo do conector do Tableau (TACO)

O arquivo do conector do Tableau é chamado de looker_v1.0.0.taco. Cada usuário precisa fazer o download do arquivo TACO e salvá-lo no computador seguindo estas etapas:

  1. Para fazer o download do arquivo do conector do Tableau, clique no seguinte link: looker_v1.0.0.taco

  2. Quando o download for concluído, mova o arquivo looker_v1.0.0.taco para o subdiretório Connectors do diretório My Tableau Repository. Estes são os caminhos de diretório padrão:

    • Windows:

      C:\Users\\Windows user\Documents\My Tableau Repository\Connectors

    • MacOS:

      /Users/Mac user/Documents/My Tableau Repository/Connectors

Arquivo do driver JDBC (looker.jar)

O driver JDBC é chamado de avatica-<release_number>-looker.jar. Cada usuário precisa fazer o download do arquivo looker.jar do GitHub e salvá-lo no computador seguindo estas etapas:

  1. Acesse https://github.com/looker-open-source/calcite-avatica/releases.
  2. Faça o download da versão mais recente do arquivo avatica-<release_number>-looker.jar.

  3. Salve o arquivo avatica-<release_number>-looker.jar no computador de cada usuário no seguinte local:

    • Windows: C:\Program Files\Tableau\Drivers

    • MacOS: /Library/JDBC ou ~/Library/JDBC

Conectar-se aos dados do Looker no Tableau Desktop

Depois de baixar e salvar os arquivos looker_v1.0.0.taco e avatica-<release_number>-looker.jar, siga estas etapas para usar o Tableau Desktop e se conectar aos dados da sua instância do Looker:

  1. No Tableau Desktop, no painel Conectar à esquerda, na seção A um servidor, selecione a opção Mais....
  2. Na caixa de pesquisa, digite Looker by Google.
  3. Selecione a opção Looker do Google.
  4. Na janela de diálogo, insira estes parâmetros:
    • Servidor: insira o URL da instância do Looker sem o https://. Por exemplo: example.cloud.looker.com
    • Porta: 443
    • Autenticação: OAuth
    • URL da instância do OAuth: insira o URL completo da instância do Looker com o https://. Por exemplo: https://example.cloud.looker.com
  5. Selecione Fazer login. O Tableau vai abrir uma janela do navegador para se conectar à sua instância do Looker e autenticar sua conta com o OAuth.
  6. Se solicitado, faça login no Looker. Se você já tiver feito login, uma mensagem vai aparecer na janela do navegador informando que o Tableau usou a janela para autenticar o Looker e que agora você pode fechar a janela.
  7. Depois que você se autenticar no Looker, o Tableau vai abrir uma página Fonte de dados com uma conexão à sua instância do Looker.
  8. Use o menu suspenso Esquema para selecionar um modelo do Looker com os dados que você quer ver no Tableau Desktop. O Tableau vai preencher a lista Tabela com as Análises do modelo do Looker selecionado.
  9. Para começar a analisar os dados, selecione e arraste um objeto da lista Tabelas para a tela.

Identificar consultas do conector de BI do Looker e do Tableau na interface do Looker

As consultas do Tableau são feitas pela interface SQL aberta. Os administradores do Looker podem usar a interface do Looker para identificar quais consultas foram originadas da interface Open SQL, conforme descrito na documentação da interface Open SQL.

As consultas do conector de BI do Looker–Tableau têm um valor Source de "sql_interface" ou "SQL Interface".

Como usar o conector de BI do Looker–Tableau no Tableau Server

O conector de BI do Looker–Tableau não está disponível no Tableau Exchange, mas é possível instalá-lo no Tableau Server seguindo os procedimentos nas seções abaixo:

Antes de começar

Sua instância do Looker precisa atender aos seguintes requisitos para usar o conector de BI do Looker–Tableau no Tableau Server:

  • Executar o Looker 24.14 ou mais recente.
  • Contém um projeto da LookML que usa dados de uma conexão do Google BigQuery:
    • O projeto do LookML precisa ser configurado para que o campo Conexões permitidas seja definido como a opção Somente estas conexões com pelo menos uma conexão do Google BigQuery selecionada. Consulte a página de documentação Como acessar e editar informações do projeto para saber como configurar um modelo e ver as conexões permitidas para ele.
    • O projeto do LookML precisa ter um arquivo model que especifique uma conexão do BigQuery no parâmetro connection.

Além disso, cada pessoa que usa o conector de BI do Looker–Tableau precisa ter uma conta do Looker com uma função de usuário que inclua a permissão explore no modelo LookML que ela quer acessar no Tableau.

Configurar o OAuth para o conector de BI do Looker e do Tableau

Para usar o conector de BI do Looker–Tableau para o Tableau Server, configure a integração do OAuth na sua instância do Looker.

Use o API Explorer do Looker para configurar a integração do OAuth para o conector de BI do Looker e do Tableau:

  • Se a instância do Looker já tiver o API Explorer instalado, acesse-o com este formato de URL:

    https://LOOKER_INSTANCE_URL/extensions/marketplace_extension_api_explorer::api-explorer/

  • Se a sua instância do Looker não tiver o API Explorer, instale-o no Looker Marketplace. Consulte a página Como usar o API Explorer para mais informações.

Para usar o API Explorer e configurar a integração do OAuth na sua instância do Looker, siga estas etapas:

  1. Abra o Looker API Explorer. Consulte a página Usar o API Explorer para mais informações.
  2. No campo Pesquisar do API Explorer, insira Registrar app OAuth.
  3. Nos resultados da pesquisa, clique em Registrar app OAuth.
  4. Na página Registrar app OAuth, clique no botão Executar.

  5. Na guia Solicitação da caixa de diálogo Executar, insira as seguintes informações nos campos correspondentes:

    • client_guid:
    tableau-server
    • body:
    {
  "redirect_uri": TABLEAU_SERVER_INSTANCE_URL/auth/add_oauth_token,
  "display_name": "Looker-Tableau-Server (manual)",
  "description": "Client for Looker-Tableau Server integration (manually added)",
  "enabled": true,
  "group_id": ""
}

  6. Marque a caixa de seleção Entendo que este endpoint de API vai mudar os dados.

  7. Clique em Executar.

  8. Para verificar se a autenticação foi configurada corretamente, use o método Get OAuth Client App no API Explorer:

    • No campo Pesquisar do API Explorer, insira Get OAuth Client App.
    • Clique em Executar.
    • No campo client_guid, insira este valor: tableau-server

    Se você configurar o OAuth corretamente, a guia Resposta vai retornar os valores inseridos ao registrar o app.

Instalar o conector de BI do Looker–Tableau no Tableau Server

Para instalar o conector de BI do Looker–Tableau no Tableau Server, siga estas etapas:

  1. Clique no link a seguir para baixar o arquivo do conector do Tableau: looker_v1.0.0.taco
  2. Faça o download da versão mais recente do arquivo avatica-<release_number>-looker.jar em https://github.com/looker-open-source/calcite-avatica/releases.
  3. Instale os arquivos TACO e JAR na máquina host do Tableau Server. O local dos arquivos depende do sistema operacional do servidor. Os caminhos de instalação padrão do Tableau são mostrados na tabela a seguir:

Servidor Linux

Local do arquivo TACO Local do arquivo JAR 
/opt/tableau/connectors
 
/opt/tableau/tableau_driver/jdbc

Windows Server

Local do arquivo TACO Local do arquivo JAR 
C:\Program Files\Tableau\Connectors
 
C:\Program Files\Tableau\Drivers

Concluir a configuração no Tableau Server

Depois de configurar o OAuth para o conector de BI do Looker–Tableau e instalar o conector de BI do Looker–Tableau, conclua a configuração realizando os procedimentos a seguir na máquina host do Tableau Server:

Informações importantes

Ao analisar dados do Looker com o Tableau Desktop, observe as seguintes considerações:

  • O conector de BI do Looker–Tableau é criado com base na interface SQL aberta do Looker e tem as mesmas limitações de LookML e SQL que ela. Consulte a documentação da Interface Open SQL para mais detalhes.
  • O Tableau consulta automaticamente o banco de dados sempre que uma mudança é feita na consulta, inclusive quando campos são adicionados e removidos usando o conector de BI do Looker e do Tableau. É possível desativar as atualizações automáticas no Tableau. Consulte a documentação do Tableau para mais informações.
  • Não é possível usar o Tableau para unir duas análises detalhadas do Looker. Se quiser unir Análises, use o Looker para criar as junções no seu modelo do Looker. Consulte as páginas de documentação do Looker Como trabalhar com junções no LookML e Parâmetros de junção para informações sobre como usar junções no Looker.
  • O conector de BI do Looker–Tableau foi projetado para funcionar com uma conexão ativa no Tableau. O modo de extração de dados do Tableau extrai medidas do Looker com um valor "nulo" e, portanto, não produz resultados precisos. Se quiser usar o modo de extração, crie campos agregados no Tableau diretamente dos campos de dimensão do Looker, em vez de usar medidas do Looker.