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

O conector de BI Looker-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 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 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.

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

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, 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 Para um servidor, selecione a opção Mais.
  2. Na caixa de pesquisa, digite Looker by Google.
  3. Selecione a opção Looker by 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 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 Looker-Tableau têm um valor Origem de "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 Looker-Tableau 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 Register OAuth App, 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 de 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 Get OAuth Client App.
    • 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:

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 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 analisar dados do Looker com o Tableau Desktop, considere o seguinte:

  • O conector de BI Looker-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.