Conector do Looker para Excel

Com o conector do Looker para Excel, é possível exportar consultas de uma Análise do Looker para um formato reconhecido pelo Microsoft Excel. Quando o conector do Looker-Excel está ativado, as análises do Looker mostram a opção Abrir no Excel no menu de engrenagem da análise. Quando você seleciona essa opção, o Looker exporta a consulta do recurso "Explorar" para um arquivo ODC no seu PC Windows. Se você tiver o driver ODBC instalado, abra o arquivo ODC no Microsoft Excel para Windows.

Antes de começar

Para usar o conector do Looker e do Excel, você precisa ter o seguinte:

  • Um PC Windows de 64 ou 32 bits.
  • Uma instância do Looker que atenda aos seguintes requisitos:
    • Executar o Looker 25.16 ou mais recente.
    • Ativado para o conector de BI do Microsoft Excel. Um administrador do Looker precisa ativar a opção Microsoft Excel na página Conectores de BI do Looker.
  • Uma conta do Looker com uma função de usuário que inclui a permissão explore no modelo LookML que o usuário quer acessar com o conector do Looker para Excel.

Você também precisa instalar o driver ODBC, conforme descrito na seção a seguir.

Como instalar o driver ODBC

O driver ODBC do Looker é um software que precisa ser instalado na máquina local de cada usuário do conector Looker-Excel. O driver ODBC permite que clientes compatíveis com ODBC se conectem à sua instância do Looker como se ela fosse um banco de dados SQL.

Para usar um driver ODBC, você precisa ter um programa gerenciador ODBC instalado. O Windows geralmente vem pré-instalado com um programa chamado Fontes de dados ODBC como ferramenta de gerenciamento. Para mais informações, consulte a documentação da Microsoft sobre o Administrador de fontes de dados ODBC.

Para instalar o driver ODBC, siga estas etapas:

  1. Use os links a seguir para fazer o download do instalador ODBC mais recente para a arquitetura do seu sistema Windows (64 ou 32 bits):

  2. Abra o arquivo de instalação do ODBC e siga as instruções na tela.

  3. Uma caixa de diálogo do Windows pode aparecer com a mensagem O Windows protegeu seu PC. Se essa caixa de diálogo aparecer, clique no link Mais informações e depois no botão Executar mesmo assim.

Na primeira vez que você abrir um arquivo ODC depois de instalar o driver ODBC no seu PC Windows, o Windows vai pedir para você criar um nome da fonte de dados (DSN) para usar o driver ODBC com clientes ODBC, como o Excel. O DSN é uma configuração salva que contém as informações da sua instância do Looker e as credenciais de autenticação.

Como usar o conector do Looker para Excel

Depois de atender aos pré-requisitos e instalar o driver ODBC no computador, siga estas etapas para abrir os dados do Looker no Microsoft Excel:

  1. No seu PC Windows, abra a instância do Looker em um navegador.
  2. Abra uma análise detalhada e execute uma consulta.
  3. Clique no menu de engrenagem "Analisar" e selecione a opção Abrir no Excel.

  4. Na caixa de diálogo Abrir no Excel, selecione uma das seguintes opções em Número de linhas e colunas a serem incluídas:

    • Tabela de resultados atual: selecione essa opção para incluir todas as linhas e colunas da tabela de resultados atual na análise detalhada. O número de linhas é limitado pelo valor do Limite de linhas da análise detalhada.
    • Todos os resultados: selecione esta opção para incluir todos os resultados retornados pela consulta ao seu banco de dados. A opção Todos os resultados geralmente fica desativada para consultas que têm Totais de linha ativados ou que recuperam dados de um dialeto de banco de dados que não pode transmitir resultados porcentagem do total ou que contêm os seguintes tipos de medidas: porcentagem do anterior ou totais acumulados. Aviso: mesmo quando a opção Todos os resultados está disponível, tenha cuidado ao baixar todos os resultados. Algumas consultas são muito grandes, contendo milhares ou milhões de linhas, o que pode sobrecarregar a maioria dos programas de planilhas ou até mesmo sua instância do Looker.
    • Personalizado: selecione essa opção para especificar manualmente o número de linhas e colunas a serem incluídas no download do arquivo ODC.
    • Os usuários com permissão de download_without_limit podem inserir um tamanho de linha de até 100.000 e um tamanho de coluna de até 200.
    • Os usuários com permissão de download_with_limit podem inserir um tamanho de linha de até 5.000 linhas e um tamanho de coluna de até 200.
    • Para usuários sem permissão de download_with_limit ou download_without_limit, a opção Abrir no Excel não será exibida.

  5. Na caixa de diálogo Abrir no Excel, clique em Fazer o download. Um arquivo ODC será baixado no seu computador.

  6. Abra o arquivo ODC com o Microsoft Excel.

  7. O Microsoft Excel mostra um aviso de segurança sobre conexões de dados bloqueadas. Clique em Ativar para ativar a conexão de dados.

  8. O Windows apresenta uma caixa de diálogo para configurar o DSN do Google Looker. Configure o DSN seguindo estas etapas:

    1. No menu suspenso Tipo de autenticação, selecione OAuth. Embora o OAuth seja a opção preferida, você pode selecionar Autenticação básica, se necessário. Se você selecionar Autenticação básica, será necessário inserir as credenciais da API Looker. Consulte a seção Autenticação usando autenticação básica nesta página.
    2. Clique em Login. Isso vai abrir um navegador da Web que faz a autenticação na sua conta do Looker. Depois que o navegador da Web mostrar um login bem-sucedido, feche-o e volte para a caixa de diálogo DSN.
    3. Clique em OK na caixa de diálogo DSN.
    4. Se solicitado, clique em OK para concordar em substituir o DSN.

O Excel executa a consulta e insere os dados em um novo objeto de tabela dinâmica. A partir daí, você pode usar os dados em cálculos e visualizações.

Se você quiser recuperar dados atualizados, faça o seguinte:

  • Para executar a mesma consulta e receber os dados mais recentes do Looker, clique no botão Atualizar na faixa de opções do Excel.
  • Para modificar a consulta, use a interface da Análise do Looker para atualizar a consulta e selecione a opção Abrir na Análise para baixar um novo arquivo ODC. Em outras palavras, comece de novo na etapa 1 deste procedimento. Por padrão, o Excel abre um novo arquivo ODC em uma nova pasta de trabalho do Excel. Se você quiser mover uma tabela dinâmica de uma pasta de trabalho para outra, clique e arraste a planilha entre as pastas de trabalho do Excel ou copie e cole a tabela dinâmica de uma pasta de trabalho para outra.

Limitações

O conector do Looker para Excel é compatível apenas com Windows, não com computadores Mac ou Linux.

Os seguintes recursos de consulta do recurso Detalhar não são compatíveis com o conector do Looker para Excel:

Se quiser abrir uma consulta do recurso Análise no Microsoft Excel, remova os cálculos de tabela e as colunas dinâmicas antes de selecionar Abrir no Excel no menu de engrenagem do recurso.

Solução de problemas

As seções a seguir fornecem informações sobre procedimentos e ferramentas de solução de problemas:

Adicionar um DSN manualmente

Quando você abre um arquivo ODC com o Excel, o Windows pede para criar o DSN. Se você precisar criar ou editar manualmente o DSN, use o Administrador de fonte de dados do driver ODBC do Windows.

Para criar ou editar manualmente o DSN, siga estas etapas:

  1. No painel de controle do seu PC Windows, abra o aplicativo Fontes de dados ODBC. Antes do Windows 8, esse aplicativo era chamado de Administrador de fontes de dados do driver ODBC.
  2. Clique no botão Adicionar.
  3. Clique duas vezes em Driver ODBC do Google Looker.
  4. Na caixa de diálogo Configurar DSN do Google Looker, preencha os seguintes campos:
    • Nome da fonte de dados*: (opcional) insira um nome para sua fonte de dados para ajudar você a reconhecer esse DSN no futuro.
    • Host: insira o URL da sua instância do Looker.
    • Porta: digite a porta para se conectar à instância do Looker. O padrão é 443.
    • No menu suspenso Tipo de autenticação, selecione OAuth. Embora o OAuth seja a opção preferida, você pode selecionar Autenticação básica, se necessário. Se você selecionar Autenticação básica, será necessário inserir as credenciais da API Looker. Consulte a seção Autenticação usando autenticação básica nesta página.
  5. Clique em Login. Isso vai abrir um navegador da Web que faz a autenticação na sua conta do Looker. Depois que o navegador da Web mostrar um login bem-sucedido, feche-o e volte para a caixa de diálogo DSN.
  6. Clique em Testar para verificar a conexão.
  7. Clique em OK na caixa de diálogo DSN.
  8. Se solicitado, clique em OK para concordar em substituir o DSN.

Autenticar usando a autenticação básica

O OAuth é a maneira preferida de autenticar no Looker. Como alternativa, se você selecionar Autenticação básica como o Tipo de autenticação na caixa de diálogo DSN, poderá autenticar usando o ID do cliente e a Chave secreta do cliente da chave de API. Consulte a página de documentação Configurações de administrador - Usuários para informações sobre como criar chaves de API.

Registros do instalador

Se você precisar acessar os registros do instalador para resolver problemas do conector do Looker para Excel, acesse o diretório C:\Users\<username>\lookerODBCLogs. Os nomes dos registros do instalador usam o seguinte formato:

  Google_Looker_ODBC_<32/64>-bit_Driver_<timestamp>

Como atualizar o Microsoft Visual C++ Redistribuível (MSVC)

O pacote redistribuível do Microsoft Visual C++ (MSVC) versão 14 é instalado automaticamente se ainda não estiver presente.

Se o pacote MSVC já estiver instalado, o instalador do driver ODBC do Google Looker não vai fazer upgrade dele. Para usar a versão do MSVC incluída no driver, desinstale o pacote do MSVC atual antes de executar o instalador.

Depois de desinstalar o driver, o pacote MSVC permanece instalado para oferecer suporte a outros aplicativos. Você pode desinstalá-lo manualmente se não precisar mais dele.