Conector Looker-Tableau (pré-lançamento público)

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

Este guia é destinado ao Acesso antecipado do conector Looker-Tableau. Para fazer perguntas ou compartilhar feedback, envie um e-mail para tableau-looker@google.com.

Requisitos

Os seguintes componentes são necessários para usar o conector Looker-Tableau:

Além disso, você precisa concluir as seguintes etapas antes de configurar o conector Looker-Tableau:

Como configurar o Tableau Desktop para se conectar ao Looker

Para usar o conector Looker-Tableau no pré-lançamento público, faça o seguinte:

  1. Adicione o aplicativo OAuth do Tableau à sua instância do Looker: um administrador do Looker precisa usar a API Looker para registrar o aplicativo OAuth do Tableau no Conector Looker-Tableau da sua instância do Looker. O aplicativo OAuth do Tableau precisa ser registrado apenas uma vez para cada instância do Looker e se aplica a todos os usuários na instância do Looker.
  2. Faça o download e salve o arquivo do Conector do Tableau e o arquivo do driver JDBC: cada usuário que quiser acessar o Conector Looker-Tableau precisa fazer o download do arquivo avatica-<release_number>-looker.jar e do conector do Tableau (.taco) empacotado e salvar os arquivos em diretórios específicos no computador.

As seções abaixo descrevem essas etapas em detalhes.

Adicionar o aplicativo OAuth do Tableau à instância do Looker

O conector Looker-Tableau exige que você tenha o aplicativo OAuth do Tableau em sua instância do Looker. A maneira mais fácil de registrar o aplicativo OAuth Tableau na sua instância do Looker é usar o Explorador de APIs do Looker.

Se a instância do Looker já tiver o APIs Explorer instalado, você poderá acessá-lo com este formato de URL:

https://<YOUR LOOKER INSTANCE URL>/extensions/marketplace_extension_api_explorer::api-explorer/

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

Use o APIs Explorer para registrar o aplicativo OAuth do Tableau na sua instância do Looker, conforme descrito nas etapas a seguir:

  1. Abra o Looker API Explorer (consulte a página Como usar o APIs Explorer para mais informações).
  2. No campo Pesquisa do APIs Explorer, digite 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 Request da caixa de diálogo Run It, digite as seguintes informações nos campos correspondentes:

    • client_guid:

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

    • body:

      {
"redirect_uri": "http://localhost:55556/Callback",
"display_name": "Tableau Desktop",
"description": "Tableau Desktop client for JDBC Server",
"enabled": true,
"group_id": ""
}

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

  7. Clique em Executar.

  8. Você pode verificar se registrou o aplicativo OAuth do Tableau com sucesso usando o método Get OAuth Client App no APIs Explorer:

    • No campo Pesquisa do APIs Explorer, digite Receber app cliente OAuth.
    • Clique em Run It.

    • No campo client_guid, insira o valor do aplicativo OAuth do Tableau:

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

    Se você registrou o aplicativo OAuth do Tableau com sucesso, a guia Resposta retornará os valores que você inseriu quando registrou o aplicativo.

Essa etapa não é necessária. No entanto, se você não usar mais o conector Looker-Tableau e quiser remover o aplicativo OAuth do Tableau, consulte Como remover o aplicativo OAuth.

Fazer o download e salvar os arquivos do conector

Para usar o conector Looker-Tableau, cada usuário do Tableau deve baixar estes dois arquivos:

As seções a seguir fornecem instruções para fazer o download desses arquivos e onde colocá-los no seu computador.

Arquivo do conector do Tableau (.taco)

O arquivo do conector do Tableau é chamado de looker-jdbc-v0.2.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-jdbc-v0.2.0.taco.

  2. Quando o download for concluído, mova o arquivo looker-jdbc-v0.2.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/[user]/Documents/My Tableau Repository/Connectors

Arquivo de driver (looker.jar) do JDBC

O driver do 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 no seguinte local:

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

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

Como se conectar aos dados do Looker no Tableau versão desktop

Depois de adicionar o aplicativo OAuth do Tableau à sua instância do Looker e fazer o download dos arquivos looker-jdbc-v0.2.0.taco e avatica-<release_number>-looker.jar, use o Tableau versão 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 JDBC by Google.
  3. Selecione a opção JDBC do Google.
  4. Na janela de diálogo, insira estes parâmetros:
    • Server (Servidor): insira o URL da instância do Looker sem 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 https://. Por exemplo: https://example.cloud.looker.com
  5. Selecione Fazer login. O Tableau abrirá uma janela do navegador para se conectar à sua instância do Looker e autenticar sua conta com OAuth.
  6. Se solicitado, insira suas credenciais do OAuth. Se você já tiver feito login, verá uma mensagem na janela do navegador informando que o Tableau usou essa janela para se autenticar no Looker e que agora é possível fechá-la.
  7. Depois da autenticação no Looker, o Tableau 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 model do Looker com os dados que você quer visualizar no Tableau versão desktop. O Tableau vai preencher a lista Table 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.

Identificar consultas do conector Looker-Tableau na interface do Looker

As consultas do Tableau são feitas através da interface Open SQL. 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 Interface aberta do SQL.

As consultas do conector Looker-Tableau têm o valor Source de "sql_interface" ou "Interface SQL".

Informações importantes

Quando você estiver explorando dados do Looker com o Tableau Desktop, observe as seguintes considerações:

  • O conector Looker-Tableau é baseado na interface Open SQL do Looker e tem as mesmas limitações do LookML que a interface Open SQL. Consulte a documentação Interface SQL aberta para mais detalhes.
  • O Tableau consulta automaticamente o banco de dados sempre que uma alteração é feita na consulta, inclusive quando campos são adicionados e removidos usando o conector Looker-Tableau. Você pode desativar as atualizações automáticas no Tableau. Para mais informações, consulte a documentação do Tableau.
  • Não é possível usar o Tableau para juntar duas Análises do Looker. Se você quiser mesclar as Análises, use o Looker para criar as mesclas 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 informações sobre como usar mesclagens no Looker.

Para informar um bug

Para informar um bug, envie um e-mail para tableau-looker@google.com e inclua as seguintes informações:

  • Uma lista detalhada das etapas que você seguiu
  • Comportamento esperado
  • O comportamento real (com uma captura de tela, se possível)

Como remover o aplicativo OAuth do Tableau (opcional)

Esta etapa não é obrigatória. No entanto, se no futuro você não usar mais o conector Looker-Tableau e quiser remover o aplicativo OAuth do Tableau da sua instância do Looker, é possível fazer isso com o APIs Explorer, seguindo estas etapas:

  1. Abra o Looker API Explorer (consulte a página Como usar o APIs Explorer para mais informações).
  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 Excluir app cliente OAuth, clique no botão Executar.

  5. Na guia Solicitação da caixa de diálogo Executar, insira o valor client_guid do aplicativo Tableau OAuth:

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

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

  7. Você pode verificar se removeu com sucesso o aplicativo OAuth do Tableau usando o método Get OAuth Client App no APIs Explorer:

    • No campo Pesquisa do APIs Explorer, digite Receber app cliente OAuth.
    • Clique em Run It.

    • No campo client_guid, insira o valor do aplicativo OAuth do Tableau:

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

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