Como usar as páginas conectadas para o Looker

Com as páginas conectadas para o Looker, os usuários analisam os dados de modelos do LookML de forma interativa usando a interface conhecida das Planilhas Google. Os usuários das Planilhas terão acesso a dados controlados de mais de 50 bancos de dados compatíveis com o Looker. A exploração é intuitiva, já que as páginas conectadas apresentam uma visualização organizada do modelo com visualizações, campos e medidas, assim como foram definidas no Looker. Os dados do Looker nas páginas conectadas podem ser usados em arquivos padrão do Planilhas, como tabelas dinâmicas, gráficos e fórmulas. Isso aumenta a flexibilidade da análise em tipos de arquivos conhecidos.

Ativar as páginas conectadas

Para usar as páginas conectadas:

  • No Looker (original), o administrador precisa ativar o Todos os conectores de BI do Looker ou a Páginas conectadas no painel de conectores de BI na seção Plataforma do menu Administrador do Looker. No Looker (Google Cloud Core), essas opções são ativadas por padrão.
  • Sua instância do Looker precisa ser hospedada pelo Looker.
  • Sua instância do Looker precisará executar o Looker 22.20 ou posterior se estiver hospedada no Google Cloud. Se a instância do Looker não estiver hospedada no Google Cloud, ela precisará executar o Looker 23.4 ou posterior.
  • Cada usuário que quiser se conectar à sua instância do Looker pelas Planilhas Google precisa usar o mesmo endereço de e-mail na conta de usuário do Looker que usa na conta do Google Workspace. Se os endereços de e-mail das contas do Google Workspace e do Looker forem diferentes, eles vão receber um erro quando tentarem se conectar ao Looker pelas Planilhas.
  • O acesso a serviços que não são controlados individualmente precisa ser ativado no seu Admin Console do Google Workspace. Essa opção geralmente fica ativada por padrão. Para mais informações, consulte o artigo de ajuda Gerenciar o acesso aos serviços que não são controlados individualmente.

Como se conectar ao Looker usando as Planilhas Google

  1. No menu Dados das Planilhas Google, selecione Conectores de dados e Conectar ao Looker.

  2. Na caixa de diálogo Conectar ao Looker, insira o nome da sua instância do Looker ou selecione o nome de uma instância a que você se conectou recentemente e selecione Continuar.

  3. Nas caixas de diálogo a seguir, selecione o modelo do Looker e a Análise que você quer usar na consulta e clique em Conectar.

Quando o app Planilhas se conecta à sua instância do Looker, uma nova planilha mostra a estrutura da Análise selecionada, incluindo visualizações, dimensões, medidas e descrições de campo que foram adicionadas pelo desenvolvedor do Looker.

Criar consultas do Looker usando as Planilhas Google

As consultas do Looker são criadas usando uma tabela dinâmica do app Planilhas. Para adicionar dados do Looker à planilha:

  1. Na página que mostra a Análise, selecione Tabela dinâmica.

  2. Escolha se você quer inserir uma nova tabela dinâmica em uma página nova ou existente e selecione Criar.

    Uma nova tabela dinâmica vazia é criada e a janela Editor de tabelas dinâmicas é aberta. É possível adicionar linhas, colunas, valores e filtros para criar consultas com base nas dimensões e medidas no Análise detalhada do Looker.

    As linhas, colunas, valores e filtros no editor de tabela dinâmica são equivalentes às dimensões e medidas do Looker das seguintes maneiras:

    • As linhas são equivalentes às dimensões do Looker.
    • As colunas são equivalentes às dimensões dinamizadas do Looker.
    • Os valores são equivalentes às medidas do Looker. Para criar uma métrica personalizada, selecione uma dimensão do Looker e uma função Resumo por das Planilhas.
    • Os filtros são equivalentes aos filtros do Looker.

    O editor dinâmico também exibe uma lista das visualizações que fazem parte da Análise, que pode ser selecionada para mostrar as dimensões e medições incluídas nessa visualização.

  3. Selecione Adicionar para incluir uma linha, coluna, valor ou filtro. As páginas conectadas mostra uma lista das visualizações disponíveis em "Explorar". Selecione um nome de visualização para mostrar a lista de dimensões e medidas na visualização e, em seguida, selecione o campo que fornece os dados da linha, coluna, valor ou filtro.

  4. Depois de adicionar os campos e filtros do Looker para criar a consulta, selecione Aplicar. Isso vai preencher sua planilha com dados da sua instância do Looker.

Depois de adicionar seus dados do Looker a uma tabela dinâmica, você poderá usar as Planilhas Google para formatar os dados ou criar novas fórmulas com base nos dados do Looker.

Opções de filtragem

Desde o lançamento inicial das páginas conectadas para o Looker, novas opções de filtragem foram adicionadas.

Filtrar por valor: adicionado em agosto de 2023

É possível filtrar as dimensões do Looker nas tabelas dinâmicas das páginas conectadas para o Looker. Para isso, basta acessar uma lista de valores e selecionar e desmarcar os valores de interesse. Antes, era necessário digitar os valores do filtro manualmente ao usar a filtragem por uma condição.

Para usar esse recurso, adicione um campo à seção Filtros da tabela dinâmica e clique no menu suspenso Status para abrir as opções de filtro. Em seguida, clique em Adicionar filtro:

Uma barra lateral será aberta, e as Planilhas vão buscar os 500 valores mais frequentes do Looker.

Você pode pesquisar os itens, selecionar ou limpar tudo ou classificar os itens por frequência ou em ordem alfabética. Quando você clicar em OK na parte de baixo, as planilhas vão armazenar suas escolhas. Clique em Aplicar para atualizar a tabela dinâmica como de costume, com o novo filtro aplicado.

Filtros que usam as expressões de filtro do Looker: adicionados em setembro de 2023

É possível aplicar filtros de data relativa e vários outros filtros avançados nas páginas conectadas usando as expressões de filtro do Looker. Por exemplo, você pode aplicar filtros como "nos últimos 30 minutos". ou "nos últimos 10 dias" nas páginas conectadas.

Para usar as expressões de filtro do Looker:

  1. Adicione um campo à seção de filtros da tabela dinâmica.

  2. Clique no menu suspenso Status para mostrar as opções de filtro e selecione Expressão de filtro.

  3. Insira qualquer expressão de filtro do Looker no campo Valor.

    Por exemplo, para filtrar os últimos sete dias, escreva "7 dias" ou "últimos 7 dias".

  4. Clique em OK.

Além da filtragem de data relativa, outros exemplos de filtragem que agora são possíveis incluem:

  • Uma string que não começa com: -FOO%
  • Um intervalo numérico inclusivo e exclusivo: (12, 20]

Para conferir todas as expressões de filtro disponíveis, consulte a página de documentação Expressões de filtro do Looker.

Uso de parâmetros do Looker e campos somente para filtros: adicionado em outubro de 2023

Agora é possível usar parâmetros e campos somente para filtros nas páginas conectadas.

Os campos e parâmetros somente para filtros vão aparecer na seção CAMPOS SOMENTE PARA FILTROS do seletor de campo nas Planilhas, assim como acontece no Looker. Para usá-los, siga estas etapas:

  1. Adicione ou arraste os parâmetros selecionados e os campos somente para filtros para a seção Filtros, assim como você faria para filtrar uma dimensão ou medida.
  2. Para parâmetros com valores permitidos, esses valores serão exibidos em um menu suspenso na caixa de diálogo Filtrar por condição.
  3. Para campos somente filtro, use a caixa de diálogo Filtrar por condição normal. Se o campo tiver sugestões definidas no modelo do Looker, também será possível usar o recurso filtrar por valor.

Atualizar seus dados nas Planilhas Google

Os dados na tabela dinâmica são estáticos, mas podem ser atualizados a qualquer momento. Quando você atualiza os dados, o Looker consulta o banco de dados e atualiza a tabela dinâmica com os dados mais atuais.

Tanto a tabela dinâmica quanto a planilha que mostram a Análise mostram a hora em que foram atualizadas pela última vez.

Selecione Atualizar para atualizar os dados na tabela dinâmica.

Programação de horários de atualização regulares

Para programar atualizações automáticas dos seus dados, selecione o menu de três pontos na tabela dinâmica e escolha Opções de atualização ou Opções de atualização na planilha "Explorar". O Looker mostra a caixa de diálogo Atualização programada.

Como editar as configurações da tabela dinâmica

Para modificar quais linhas, colunas, valores ou filtros são incluídos na tabela dinâmica, selecione o ícone de lápis ao lado do menu de três pontos para abrir o painel do editor de tabelas dinâmicas.

Monitorar páginas conectadas

Um administrador do Looker pode conferir o uso das páginas conectadas usando o grupo de campos Propriedades do cliente da API Query na Análise do histórico de atividades do sistema. Uma entrada é criada na Análise detalhada Histórico sempre que uma nova consulta é executada.

No grupo de campos Propriedades do cliente da API de consulta, há três novos campos para as páginas conectadas:

  • Nome do cliente da API: esse campo sempre mostra Connected Sheets para identificar as entradas das Páginas conectadas.
  • ID da planilha das páginas conectadas: esse campo mostra o ID da planilha, que é incluído no URL das Planilhas Google dela.
  • Acionador de planilhas conectadas: mostra se a consulta foi acionada por um usuário que selecionou o botão Atualizar nas Planilhas ou por uma atualização programada.

Confira a seguir um exemplo de URL de atividade do sistema que mostra o uso das Páginas conectadas. Substitua <instance_name.looker.com> pelo URL da instância.

https://<instance_name.looker.com>/explore/system__activity/history?fields=query_api_client_context.name,query_api_client_context.cs_spreadsheet_id,query_api_client_context.cs_trigger,user.name,history.created_date,history.created_time_of_day&f[query_api_client_context.cs_spreadsheet_id]=-NULL&sorts=history.created_time_of_day+desc&limit=5000

Suporte à API Connected Sheets

O suporte de API para as Páginas conectadas para Looker pode ser acessado pelo Apps Script e pelas APIs Google Sheets.

Algumas das coisas que você pode fazer de maneira programática com o suporte à API incluem:

  • Atualização automática de dados: é possível programar atualizações regulares nas planilhas com tecnologia Looker para garantir que você esteja usando as informações mais recentes.
  • Fluxos de trabalho personalizados: é possível criar processos complexos que incorporam dados do Looker aos seus fluxos de trabalho das Planilhas Google.
  • Integração com outros aplicativos: conecte dados do Looker a ferramentas e serviços externos usando o AppsScript ou as APIs Google Sheets.

Para especificar o Looker como uma origem de dados com a API Google Sheets, use o objeto looker com o recurso REST DataSourceSpec.

Informações úteis

  • A diferenciação entre maiúsculas e minúsculas dos dados mostrados na tabela dinâmica é determinada pela configuração de diferenciação entre maiúsculas e minúsculas do modelo. No entanto, os filtros na tabela dinâmica forçam a não diferenciação de maiúsculas e minúsculas em situações em que o filtro não diferencia maiúsculas e minúsculas para dados nativos das Planilhas.
  • Qualquer pessoa com acesso de leitor à planilha poderá acessar os dados armazenados em cache em uma tabela dinâmica.
  • Além do acesso de editor à planilha, todos os usuários que precisam editar ou atualizar a tabela dinâmica precisam das permissões corretas no Looker para acessar o modelo de dados. Isso inclui acesso ao modelo em que a tabela dinâmica é baseada, permissões para visualizar os dados e acesso adequado aos dados por meio de filtros de acesso ou permissões de acesso.
  • Se o usuário estiver fazendo a autenticação com OAuth em um banco de dados do BigQuery, talvez seja necessário conceder permissões no banco de dados subjacente.

Limites de dados e linha das páginas conectadas

As consultas criadas com as páginas conectadas têm um limite máximo de 30.000 linhas. Se o resultado da consulta tiver mais linhas, as Planilhas vão mostrar um erro para o usuário. Se o usuário não tiver a permissão download_without_limit, o resultado será truncado para um máximo de 5.000 linhas, independentemente do limite das Planilhas.

Além disso, as consultas das Planilhas conectadas estão sujeitas a um limite de tamanho de dados. Consultas que retornam dados demais também resultam em erro.

Se você encontrar um desses erros, adicione filtros ou use menos e/ou dimensões menos granulares na consulta.

Solução de problemas nas páginas conectadas

Pode haver alguns problemas ao tentar se conectar ao Looker nas Planilhas Google. Esta seção descreve esses problemas e como corrigi-los.

Erro: ocorreu um erro ao se conectar à sua instância do Looker. Tente novamente. Se o problema persistir, envie um feedback.

Esse erro pode ocorrer por vários motivos:

  • O nome da instância do Looker foi inserido incorretamente. Nesse caso, verifique o nome da instância do Looker e tente se conectar de novo.
  • As Páginas não podem se conectar à API Looker. Isso pode ocorrer se a instância do Looker não estiver usando o URL do host da API padrão. Para corrigir isso, deixe o campo URL do host da API no painel administrativo da API em branco.

Erro: a instância do Looker não está configurada para usar esse recurso. Entre em contato com seu administrador do Looker para garantir que ela está qualificada.

Esse erro pode ocorrer por vários motivos:

  • Você está tentando se conectar a uma instância recém-criada do Looker. Pode levar até 24 horas para que uma nova instância do Looker fique disponível nas páginas conectadas.
  • Você está tentando se conectar a uma instância do Looker que não é hospedada pelo Looker. Conecte-se a outra instância hospedada no Looker.

Nenhum modelo aparece após a conexão a uma instância do Looker

Isso indica que você não tem as permissões necessárias para visualizar modelos na sua instância.

Um usuário do Looker com a função de leitor não tem permissões suficientes para criar conexões nas Planilhas, assim como não tem permissões suficientes para usar a interface de Análise no Looker. Para usar as páginas conectadas para o Looker, o usuário precisa ter a permissão explore. As funções de administrador, desenvolvedor e usuário incluem a permissão explore. Um administrador do Looker pode conceder ao usuário a permissão explore, que permite que ele acesse os modelos na instância.

Erro: o endereço de e-mail da sua conta vinculada do Looker é diferente do endereço da Conta do Google.

Isso indica que o endereço de e-mail da sua conta do Looker não corresponde ao endereço de e-mail usado na sua Conta do Google. Confira se você fez login em uma Conta do Google que tem um endereço de e-mail que corresponde à sua conta do Looker. Como alternativa, um administrador do Looker pode criar uma nova conta de usuário que use seu endereço de e-mail atual do Google.

Erro: solicitação inválida: nenhum cliente ativado encontrado.

Esse erro indica que o conector das páginas conectadas não foi ativado. Um administrador do Looker precisa ativar o botão Todos os conectores de BI do Looker ou Páginas conectadas no painel de conectores de BI na seção Plataforma do menu Administrador do Looker.

Erro: 403 Proibido

Se a instância do Looker tiver uma lista de permissões de IP configurada, ela poderá impedir que o app Planilhas se conecte à API Looker. Para determinar se a causa é a lista de permissões, tente acessar o URL da instância do Looker e veja se o erro Endereço IP não está na lista de permissões aparece.