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

O conector Looker-Tableau permite usar o Tableau Desktop para se conectar a dados de uma Análise do Looker. O conector Looker–Tableau foi desenvolvido com base na interface SQL Open SQL do Looker, que permite acesso a modelos do LookML e Análises para aplicativos que usam o JDBC para conexão com fontes de dados. Consulte a documentação Interface aberta SQL para mais detalhes.

Este guia é destinado ao pré-lançamento público 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, é preciso concluir as etapas a seguir antes de configurar o conector Looker-Tableau:

Como configurar o Tableau Desktop para conexão com o Looker

Para usar o conector Looker-Tableau no Acesso antecipado, faça o seguinte:

  1. Adicionar o aplicativo OAuth do Tableau à sua instância do Looker: um administrador do Looker deve usar a API Looker para registrar o aplicativo OAuth do Tableau para o conector Looker–Tableau na 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 deve baixar o arquivo avatica-<release_number>-looker.jar e o arquivo empacotado do conector do Tableau (.taco) e, depois, salvar os arquivos em diretórios específicos do computador.

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

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

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

Se a instância do Looker já tiver o APIs Explorer instalado, é possível acessá-la 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 app Tableau OAuth na sua instância do Looker, conforme descrito nas etapas a seguir:

  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 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 Solicitação da caixa de diálogo Executar, insira 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. Verifique se você registrou o aplicativo OAuth do Tableau usando o método Get OAuth Client App no APIs Explorer:

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

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

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

    Se o aplicativo OAuth do Tableau tiver sido registrado corretamente, a guia Resposta retornará os valores inseridos com o aplicativo.

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

Faça o download e salve os arquivos do conector

Para usar o conector Looker-Tableau, cada usuário do Tableau precisa 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 de conector do Tableau chama-se 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 de conector do Tableau, clique neste link: 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:

    • No Windows: C:\Users\\[Windows User]\Documents\My Tableau Repository\Connectors

    • MacOS: /Users/[user]/Documents/My Tableau Repository/Connectors

Arquivo do driver JDBC (looker.jar)

O driver JDBC tem o nome 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:

    • No 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 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, você pode usar o Tableau Desktop para se conectar aos dados da sua instância do Looker seguindo estas etapas:

  1. No Tableau Desktop, no painel Conectar do lado esquerdo, na seção A um servidor, selecione a opção Mais....
  2. Na caixa de pesquisa, digite Looker JDBC do Google.
  3. Selecione a opção Looker JDBC by Google.
  4. Na caixa 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 à instância do Looker e autenticar sua conta com o OAuth.
  6. Se solicitado, digite suas credenciais do OAuth. Se você já tiver feito login, verá uma mensagem na janela do navegador informando que o Tableau usou a janela do navegador para se autenticar no Looker e que agora você pode fechar essa janela.
  7. Depois da autenticação no Looker, o Tableau vai abrir a 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 exibir no Tableau versão desktop. O Tableau vai preencher a lista Tabela com as Análises do Looker relacionadas ao modelo selecionado.
  9. Para começar a analisar os dados, selecione e arraste um objeto da lista Tables para a tela.

Identificar consultas do Looker – Tableau Connector na interface do Looker

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

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

Informações importantes

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

  • O conector Looker-Tableau foi desenvolvido com base na interface SQL Open SQL do Looker e tem as mesmas limitações do LookML que a interface SQL aberta. Consulte a documentação Interface aberta SQL 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. Desative as atualizações automáticas no Tableau. Consulte a documentação do Tableau (em inglês) 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 saber mais sobre o uso de 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
  • O 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, faça isso com o APIs Explorer 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 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. Verifique se o aplicativo OAuth do Tableau foi removido usando o método Get OAuth Client App no APIs Explorer:

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

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

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

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