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 aberta do SQL 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 da interface do Open SQL para mais detalhes.

O conector de BI do Looker e do 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 para o Tableau:

  • Executando 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 como configurar um modelo e conferir as conexões permitidas.
    • O projeto do LookML precisa ter um arquivo modelo 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 se conectar ao Looker

Depois que 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 de BI Looker-Tableau precisa fazer o download do arquivo avatica-<release_number>-looker.jar e do arquivo de conector de BI do Tableau (TACO) e salvá-los em diretórios específicos no 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 do conector do Tableau é chamado 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 link a seguir: 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 de 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

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:
    • 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 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 Tabelas para a tela.

Como identificar consultas do conector de BI do Looker e do Tableau na interface do Looker

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

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

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 você pode instalar o conector de BI do Looker-Tableau no Tableau Server seguindo os procedimentos nas seções a seguir:

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 no Tableau Server:

  • Executando 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 modelo 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 do Looker para o Tableau Server, você precisa configurar a integração OAuth na sua instância do Looker.

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

  • Se a instância do Looker já tiver o API Explorer instalado, você poderá 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.

Para usar o API Explorer e configurar a integração 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 app OAuth, clique no botão Run It.

  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, insira este valor: tableau-server

    Se a configuração do OAuth for bem-sucedida, 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:
Local 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

Concluir 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:

Considerações

Ao analisar dados do Looker com o Tableau Desktop, considere o seguinte:

  • 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 dois recursos Explorar do Looker. Se você quiser combinar Análises, use o Looker para criar as combinações no 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 as junções 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 versão pública de pré-lançamento do conector do Looker para o Tableau BI

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 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 ativar a opção Tableau Desktop na instância do Looker, os usuários poderão fazer o seguinte para usar a versão mais recente do conector de BI do Looker e do Tableau:

Depois que um usuário faz o download e salva o arquivo do conector do Tableau e o arquivo do driver JDBC, ele pode se conectar aos dados do Looker pelo 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 de BI do Looker e Tableau, siga o procedimento para remover o app OAuth do Tableau que você adicionou à instância do Looker como parte da configuração da prévia pública.

Como remover o app OAuth do Tableau (opcional)

Esse procedimento não é obrigatório. No entanto, depois que todos os usuários da instância do Looker tiverem feito upgrade para o arquivo de conector looker_v1.0.0.taco do Tableau, você poderá remover a versão de pré-lançamento do app OAuth do Tableau da instância do Looker seguindo 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, 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 app OAuth do Tableau. Para a versão do conector de BI do Tableau e do Looker (v0.2.0) do pré-lançamento público, o valor client_guid é:

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

  6. Marque a caixa de seleção Entendo que este endpoint da API vai 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 Pesquisar do API Explorer, digite Conferir o 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.