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 para 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 da Análise para um arquivo ODC no seu PC Windows. Se você tiver o driver ODBC instalado, poderá abrir o arquivo ODC no Microsoft Excel para Windows.

Antes de começar

Para usar o conector do Looker para 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 o cliente pré-configurado do Microsoft Excel na guia Biblioteca de aplicativos da página Gerenciar clientes OAuth (Administrador > Autenticação > Gerenciar clientes OAuth) ou ativar a chave do Microsoft Excel na página Conectores de BI do Looker.
  • Uma conta do Looker com um papel de usuário que inclua a permissão explore no modelo do LookML que o usuário quer acessar com o Looker-Excel Connector.

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 do Looker para 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, é necessário ter um programa gerenciador de ODBC instalado. O Windows geralmente vem pré-instalado com um programa chamado Fontes de dados ODBC como ferramenta de gestão. Para mais informações, consulte a documentação da Microsoft sobre o Administrador de Fonte 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 do instalador do ODBC e siga as instruções na tela.

  3. Talvez apareça uma caixa de diálogo do Windows com a mensagem O Windows protegeu seu computador. Se essa caixa de diálogo aparecer, clique no link Mais informações e, em seguida, no botão Executar mesmo assim.

Na primeira vez que você abrir um arquivo ODC após instalar o driver ODBC no PC com Windows, o Windows vai solicitar que você crie um nome de fonte de dados (DSN, na sigla em inglês) para usar o driver ODBC com clientes ODBC, como o Excel. O DSN é uma configuração salva que contém as informações da instância do Looker e as credenciais de autenticação.

Como usar o conector do Looker para Excel

Depois que os pré-requisitos forem atendidos e o driver ODBC estiver instalado no seu computador, siga estas etapas para abrir os dados do Looker no Microsoft Excel:

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

  4. Na caixa de diálogo Abrir no Excel, selecione uma das seguintes opções para 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 que estão na tabela de resultados atual na Análise. O número de linhas é limitado pelo valor de Limite de linhas da Análise.
    • Todos os resultados: selecione essa opção para incluir todos os resultados retornados pela consulta ao banco de dados. A opção Todos os resultados geralmente é desativada para consultas que têm os Totais de linhas 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 total anterior ou totais em execução. Aviso: mesmo quando a opção Todos os resultados estiver disponível, tenha cuidado ao fazer o download de todos os resultados. Algumas consultas são muito grandes, contendo milhares ou milhões de linhas, o que pode sobrecarregar a maioria dos editores 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 que serão incluídas no download do arquivo ODC.
    • Os usuários com a permissão download_without_limit podem inserir um tamanho de linha de até 100.000 e de coluna de até 200.
    • Os usuários com a permissão 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 as permissões 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á salvo no seu computador.

  6. Abra o arquivo ODC com o Microsoft Excel.

  7. O Microsoft Excel apresenta 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 preferencial, você pode selecionar Autenticação básica, se necessário. Se você selecionar Autenticação básica, precisará inserir as credenciais da API Looker. Consulte a seção Como autenticar usando a autenticação básica nesta página.
    2. Clique em Login. Isso vai abrir um navegador da Web que autentica sua conta do Looker. Depois que o navegador da Web mostrar que o login foi concluído, feche-o e volte para a caixa de diálogo do DSN.
    3. Clique em OK na caixa de diálogo DSN.
    4. Se solicitado, clique em OK para concordar com a substituição do 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 novamente 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 atualizá-la e selecione a opção Abrir na Análise para baixar um novo arquivo ODC (ou seja, comece de novo na etapa 1 deste procedimento). Por padrão, o Excel abre um novo arquivo ODC em uma nova pasta de trabalho. 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 o Windows, não com computadores Mac ou Linux.

Os seguintes recursos de consulta de Análise não são compatíveis com o conector do Looker para Excel:

Se você quiser abrir uma consulta de 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 da Análise.

Solução de problemas

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

Como adicionar um DSN manualmente

Quando você abrir um arquivo ODC com o Excel, o Windows vai pedir para você criar o DSN. Se você precisar criar ou editar o DSN manualmente, use o Administrador de Fonte de Dados do Driver ODBC do Windows.

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

  1. No painel de controle do PC Windows, abra o aplicativo Fontes de dados ODBC (antes do Windows 8, esse aplicativo era chamado de Administrador de fonte 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 o DSN do Google Looker, preencha os seguintes campos:
    • Nome da fonte de dados*: (opcional) insira um nome para a fonte de dados para ajudar a reconhecer esse DSN no futuro.
    • Host: insira o URL da sua instância do Looker.
    • Porta: insira 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 preferencial, você pode selecionar Autenticação básica, se necessário. Se você selecionar Autenticação básica, precisará inserir as credenciais da API Looker. Consulte a seção Como autenticar usando a autenticação básica nesta página.
  5. Clique em Login. Isso vai abrir um navegador da Web que autentica sua conta do Looker. Depois que o navegador da Web mostrar que o login foi concluído, feche-o e volte para a caixa de diálogo do 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 com a substituição do DSN.

Como 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 do 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 admin - Usuários para saber 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-os no 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 fazer upgrade do Microsoft Visual C++ Redistributable (MSVC)

O pacote Microsoft Visual C++ Redistributable (MSVC) versão 14 será 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 fará o 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.