Conector de BI do Looker e Tableau

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

Antes de começar

Sua instância do Looker precisa atender aos seguintes requisitos para usar o conector de BI do Looker para o 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 projeto do 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 mais sobre 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 para o 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 conexão com o Looker

Quando todos os requisitos forem atendidos, você poderá configurar o Tableau Desktop para se conectar aos dados do Looker.

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

Arquivo do conector do Tableau (TACO)

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

  1. Para fazer o download do arquivo de conector do Tableau, clique neste 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:

    • No 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 salvar o arquivo 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 neste local:

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

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

Como se conectar aos dados do Looker usando o Tableau Desktop

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

  1. No Tableau Desktop, no painel Conectar à esquerda, na seção Para 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:
    • Server: 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 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 do navegador para fazer a autenticação no Looker e que você pode fechar a janela do navegador.
  7. Depois que você fizer a autenticação no Looker, o Tableau vai abrir uma página de 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 consultar no Tableau Desktop. O Tableau vai preencher a lista Tabela com as Análises do Looker do modelo do Looker que você selecionou.
  9. Para começar a analisar os dados, selecione e arraste um objeto da lista Tables para a tela.

Identificar consultas do Looker BI Connector 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 são originadas da interface aberta SQL, conforme descrito na documentação Interface aberta SQL.

As consultas do conector de BI do Looker para o Tableau têm um valor de origem de "sql_interface" ou "Sql_interface".

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

O conector de BI do Looker–Tableau não está disponível no Tableau Exchange, mas é possível instalar o conector de BI do Looker–Tableau no Tableau Server, executando os procedimentos nas seguintes seções:

Antes de começar

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

  • executar o Looker 24.14 ou mais recente;
  • Contém um projeto do 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 conferir as conexões permitidas.
    • 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 e do 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 Looker-Tableau para o Tableau Server, é necessário configurar a integração OAuth na sua instância do Looker.

Use o APIs Explorer do Looker para configurar a integração do OAuth com o conector Looker ao Tableau BI:

  • Caso sua instância do Looker já tenha o APIs Explorer instalado, é possível acessá-lo 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 Marketplace do Looker. Consulte a página Como usar o API Explorer para mais informações.

Se quiser usar o APIs Explorer para 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 Como 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 aplicativo OAuth, clique no botão Executar.

  5. Na guia Request da caixa de diálogo Run It, 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 da API vai mudar os dados.

  7. Clique em Executar.

  8. É possível verificar se você configurou a autenticação usando o método Get OAuth Client App no API Explorer:

    • No campo Pesquisar do API Explorer, digite Conferir o app cliente OAuth.
    • Clique em Run It.
    • No campo client_guid, digite este valor: tableau-server

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

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

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

  1. Faça o download do arquivo do conector do Tableau clicando no link a seguir: 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:
Localização do arquivo TACO Local do arquivo JAR
Servidor Linux 
/opt/tableau/connectors

/opt/tableau/tableau_driver/jdbc
Windows Server 
C:\Program Files\Tableau\Connectors

C:\Program Files\Tableau\Drivers

Conclua a configuração no Tableau Server

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

Informações importantes

Ao explorar dados do Looker com o Tableau versão desktop, observe as seguintes considerações:

  • O conector de BI do Looker para o Tableau é baseado na interface SQL aberta do Looker e tem as mesmas limitações de LookML e SQL da interface SQL aberta. Consulte a documentação da interface do 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 Looker-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 mesclar duas Análises do Looker. Se você quiser participar das Análises, use o Looker para criar as mesclagens no seu modelo do Looker. Consulte as páginas de documentação do Looker Como trabalhar com mesclagens no LookML e Parâmetros de mesclagem para mais informações sobre como usar mesclagens no Looker.
  • O conector de BI do Looker para o Tableau foi projetado para funcionar com uma conexão em tempo real no Tableau. O modo de extração de dados do Tableau extrai medidas do Looker com um valor de "null" e, portanto, não produz resultados precisos. Se você quiser usar o modo de extração, crie campos agregados no Tableau diretamente nos campos de dimensão do Looker em vez de usar as medidas do Looker.

Como fazer upgrade da prévia pública do conector de BI do Looker para o Tableau

Se você participou da visualização pública do conector de BI do Looker e do Tableau, sua configuração atual vai continuar funcionando como está. No entanto, recomendamos que você faça upgrade para a versão mais recente do conector de BI do Looker e do Tableau.

Para fazer upgrade para a versão mais recente do conector de BI do Looker e do Tableau, um administrador do Looker precisa realizar as seguintes tarefas:

  1. Verifique se a instância do Looker atende aos requisitos.
  2. Na instância do Looker, ative a opção Tableau Desktop na página Conectores de BI.

Depois que um administrador do Looker ativa a opção Tableau Desktop na instância do Looker, os usuários dessa instância podem fazer o seguinte para usar o conector de BI do Looker ao Tableau mais recente:

Depois de fazer o download e salvar o arquivo do Tableau Connector e o arquivo de driver do JDBC, o usuário pode conectar-se aos dados do Looker a partir do Tableau Desktop. Os usuários vão precisar fazer a autenticação na conta do Looker no conector de BI do Looker-Tableau atualizado.

Depois que todos os usuários da instância do Looker fizerem upgrade para o novo conector Looker–Tableau BI, siga o procedimento para remover o app Tableau OAuth adicionado à sua instância do Looker como parte da configuração do Acesso antecipado.

Remoção do aplicativo OAuth do Tableau (opcional)

Esse procedimento não é obrigatório. No entanto, depois que todos os usuários da instância do Looker fizerem upgrade para o arquivo de conector do Tableau looker_v1.0.0.taco, será possível remover a versão da Private Preview do app Tableau OAuth da sua instância do Looker seguindo estas etapas:

  1. Abra a ferramenta APIs Explorer do Looker (consulte a página Como usar a API Explorer para saber mais).
  2. No campo Pesquisa do APIs Explorer, digite Excluir app cliente OAuth.
  3. Nos resultados da pesquisa, clique em Excluir app cliente OAuth.
  4. Na página Delete OAuth Client App, clique no botão Run It.

  5. Na guia Solicitação da caixa de diálogo Executar, insira o valor client_guid do aplicativo OAuth do Tableau. Para a versão de Acesso antecipado do Looker ao Tableau BI Connector (v0.2.0), o valor de client_guid é:

      35FBB268-0CB0-4822-AFE3-28638C1C6269

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

  7. Para verificar se você removeu o app OAuth do Tableau, use o método Get OAuth Client App no API Explorer:

    • No campo Pesquisa do APIs Explorer, digite Instalar app cliente OAuth.
    • Clique em Run It.
    • No campo client_guid, insira o valor do app OAuth do Tableau: 35FBB268-0CB0-4822-AFE3-28638C1C6269

    Se você tiver removido o app OAuth do Tableau, a guia Resposta vai retornar valores de corpo vazios.