Conetor do Looker para o Excel

O conetor do Looker-Excel permite-lhe exportar consultas de uma opção Explorar do Looker para um formato que o Microsoft Excel reconhece. Quando o conetor do Looker-Excel está ativado, as opções Explorar do Looker apresentam a opção Abrir no Excel no menu de roda dentada de Explorar. Quando seleciona esta opção, o Looker exporta a consulta de exploração para um ficheiro ODC no seu PC Windows. Se tiver o controlador ODBC instalado, pode abrir o ficheiro ODC no Microsoft Excel para Windows.

Antes de começar

Para usar o conector do Looker para o Excel, tem de ter o seguinte:

  • Um PC Windows de 64 ou 32 bits.
  • Uma instância do Looker que cumpre os seguintes requisitos:
    • Ter o Looker 25.16 ou posterior.
    • Ativado para o conetor de BI do Microsoft Excel. Um administrador do Looker tem de ativar o botão Microsoft Excel na página Conetores de BI do Looker.
  • Uma conta do Looker com uma função de utilizador que inclua a autorização explore no modelo LookML ao qual o utilizador quer aceder com o conetor do Looker para Excel.

Também tem de instalar o controlador ODBC, conforme descrito na secção seguinte.

Instalar o controlador ODBC

O controlador ODBC do Looker é um software que tem de ser instalado na máquina local de cada utilizador do conetor Looker-Excel. O controlador ODBC permite que os clientes compatíveis com ODBC se liguem à sua instância do Looker como se a instância fosse uma base de dados SQL.

Para usar um controlador ODBC, tem de ter um programa de gestão ODBC instalado. Normalmente, o Windows vem pré-instalado com um programa denominado Origens de dados ODBC como ferramenta de gestão. Para mais informações, consulte a documentação da Microsoft sobre o administrador de origens de dados ODBC.

Para instalar o controlador ODBC, siga estes passos:

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

  2. Abra o ficheiro do instalador ODBC e siga as instruções no ecrã.

  3. Pode ver uma caixa de diálogo do Windows com a indicação O Windows protegeu o seu PC. Se vir esta caixa de diálogo, clique no link Mais informações e, de seguida, no botão Executar mesmo assim.

Da primeira vez que abre um ficheiro ODC depois de instalar o controlador ODBC no seu PC Windows, o Windows pede-lhe que crie um nome da origem de dados (DSN) para lhe permitir usar o controlador ODBC com clientes ODBC, como o Excel. O DSN é uma configuração guardada que contém as informações da instância do Looker e as credenciais de autenticação.

Usar o conetor do Looker para o Excel

Quando os pré-requisitos forem cumpridos e o controlador ODBC estiver instalado no seu computador, pode abrir os dados do Looker no Microsoft Excel seguindo estes passos:

  1. No seu PC com Windows, abra a instância do Looker num navegador.
  2. Abra uma análise detalhada e execute uma consulta.
  3. Clique no menu de roda dentada do Explorar 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 incluir:

    • Tabela de resultados atual: selecione esta opção para incluir todas as linhas e colunas que estão na tabela de resultados atual na funcionalidade Explorar. O número de linhas é limitado pelo valor de Limite de linhas da análise detalhada.
    • Todos os resultados: selecione esta opção para incluir todos os resultados devolvidos pela consulta à sua base de dados. Normalmente, a opção Todos os resultados está desativada para consultas que tenham os Totais das linhas ativados ou que extraiam dados de um dialeto de base de dados que não pode transmitir resultados percentagem do total ou que contenham os seguintes tipos de medidas: percentagem do anterior ou totais acumulados. Aviso: mesmo quando a opção Todos os resultados está disponível, deve ter cuidado ao transferir 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 folhas de cálculo ou até mesmo a sua instância do Looker.
    • Personalizado: selecione esta opção para especificar manualmente o número de linhas e colunas a incluir na transferência do ficheiro ODC.
    • Os utilizadores com a autorização download_without_limit podem introduzir um tamanho de linha até 100 000 e um tamanho de coluna até 200.
    • Os utilizadores com a autorização download_with_limit podem introduzir um tamanho de linha até 5000 linhas e um tamanho de coluna até 200.
    • Para os utilizadores sem autorização download_with_limit nem download_without_limit, a opção Abrir no Excel não é apresentada.

  5. Na caixa de diálogo Abrir no Excel, clique em Transferir. É transferido um ficheiro ODC para o seu computador.

  6. Abra o ficheiro ODC com o Microsoft Excel.

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

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

    1. No menu pendente Tipo de autorização, selecione OAuth. Embora o OAuth seja a opção preferencial, pode selecionar Autenticação básica, se necessário. Se selecionar Autenticação básica, tem de introduzir as credenciais da API Looker. Consulte a secção Autenticação através da autenticação básica nesta página.
    2. Clique em Iniciar sessão. Esta ação abre um navegador de Internet que faz a autenticação na sua conta do Looker. Depois de o navegador de Internet mostrar que o início de sessão foi bem-sucedido, feche o navegador de Internet e volte à caixa de diálogo do DSN.
    3. Clique em OK na caixa de diálogo DSN.
    4. Se lhe for pedido, clique em OK para aceitar a substituição do DSN.

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

Se quiser obter dados atualizados, pode fazer uma das seguintes ações:

  • Para executar novamente a mesma consulta e obter os dados mais recentes do Looker, clique no botão Atualizar na faixa do Excel.
  • Para modificar a consulta, use a IU do Looker Explore para atualizar a consulta e, em seguida, selecione a opção Abrir no Explore para transferir um novo ficheiro ODC (por outras palavras, comece novamente a partir do passo 1 deste procedimento). Por predefinição, o Excel abre um novo ficheiro ODC numa nova pasta de trabalho do Excel. Se quiser mover uma tabela dinâmica de um livro para outro, pode clicar e arrastar a folha entre livros do Excel ou copiar e colar a tabela dinâmica de um livro para outro.

Limitações

O conetor do Looker para Excel só é suportado no Windows e não em computadores Mac ou Linux.

As seguintes funcionalidades de consulta do Explorar não são suportadas com o conetor Looker-Excel:

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

Resolução de problemas

As secções seguintes fornecem informações sobre procedimentos e ferramentas de resolução de problemas:

Adicionar manualmente um DSN

Quando abre um ficheiro ODC com o Excel, o Windows pede-lhe que crie o DSN. Se precisar de criar ou editar manualmente o DSN, pode usar o administrador de origens de dados do controlador ODBC do Windows.

Para criar ou editar manualmente o DSN, siga estes passos:

  1. No painel de controlo do seu PC Windows, abra a aplicação Origens de dados ODBC (antes do Windows 8, esta aplicação chamava-se Administrador de origens de dados do controlador ODBC).
  2. Clique no botão Adicionar.
  3. Clique duas vezes em Controlador ODBC do Google Looker.
  4. Na caixa de diálogo Configurar DSN do Google Looker, preencha os seguintes campos:
    • Nome da origem de dados*: (opcional) introduza um nome para a origem de dados para ajudar a reconhecer este NSO no futuro.
    • Anfitrião: introduza o URL da sua instância do Looker.
    • Porta: introduza a porta para estabelecer ligação na instância do Looker. A predefinição é 443.
    • No menu pendente Tipo de autorização, selecione OAuth. Embora o OAuth seja a opção preferencial, pode selecionar Autenticação básica, se necessário. Se selecionar Autenticação básica, tem de introduzir as credenciais da API Looker. Consulte a secção Autenticação através da autenticação básica nesta página.
  5. Clique em Iniciar sessão. Esta ação abre um navegador de Internet que faz a autenticação na sua conta do Looker. Depois de o navegador de Internet mostrar que o início de sessão foi bem-sucedido, feche o navegador de Internet e volte à caixa de diálogo do DSN.
  6. Clique em Testar para validar a associação.
  7. Clique em OK na caixa de diálogo DSN.
  8. Se lhe for pedido, clique em OK para aceitar a substituição do DSN.

Autenticação através da autenticação básica

O OAuth é a forma preferencial de autenticação no Looker. Em alternativa, se selecionar Autenticação básica como Tipo de autenticação na caixa de diálogo DSN, pode autenticar-se através do ID de cliente e do segredo do cliente da chave de API. Consulte a página de documentação Definições de administrador – Utilizadores para obter informações sobre como criar chaves de API.

Registos do instalador

Se precisar de aceder aos registos do instalador para resolver problemas do conetor do Looker para Excel, pode aceder aos mesmos no diretório C:\Users\<username>\lookerODBCLogs. Os nomes dos registos do instalador usam o seguinte formato:

  Google_Looker_ODBC_<32/64>-bit_Driver_<timestamp>

Atualizar o Microsoft Visual C++ Redistributable (MSVC)

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

Se o pacote MSVC já estiver instalado, o instalador do controlador ODBC do Google Looker não o atualiza. Para usar a versão do MSVC incluída no controlador, desinstale o pacote MSVC existente antes de executar o instalador.

Depois de desinstalar o controlador, o pacote MSVC permanece instalado para suportar outras aplicações. Pode desinstalá-lo manualmente se já não precisar dele.