Com as páginas conectadas para o Looker, os usuários exploram interativamente os dados de modelos do LookML na conhecida interface das Planilhas Google. Os usuários das Planilhas Google terão acesso a dados controlados de mais de 50 bancos de dados compatíveis com o Looker. A análise detalhada é intuitiva, já que as páginas conectadas apresenta uma visualização organizada do modelo, com visualizações, campos e medidas exatamente como foram definidos no Looker. Os dados do Looker nas páginas conectadas podem ser usados em arquivos padrão do app Planilhas, como tabelas dinâmicas, gráficos e fórmulas, o que permite uma análise mais flexível em recursos conhecidos.
Ativar as páginas conectadas
Para usar as páginas conectadas:
- No Looker (original), o administrador precisa ativar os Conectores de BI do Looker ou a opção Páginas conectadas no painel 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 precisa executar a versão 22.20 ou mais recente se estiver hospedada no Google Cloud. Se a instância do Looker não estiver hospedada no Google Cloud, ela vai precisar executar o Looker 23.4 ou uma versão mais recente.
- Cada usuário que quiser se conectar à sua instância do Looker nas Planilhas Google precisa usar o mesmo endereço de e-mail na conta de usuário do Looker e do Google Workspace. Se os endereços de e-mail das contas do Google Workspace e do Looker forem diferentes, eles receberão uma mensagem de erro quando tentarem se conectar ao Looker no Planilhas.
- O acesso aos serviços que não são controlados individualmente precisa ser ativado no Admin Console do Google Workspace. Essa opção costuma ser 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.
Conectar-se ao Looker no app Planilhas Google
No menu Dados das Planilhas Google, selecione Conectores de dados e, depois, Conectar ao Looker.
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 clique em Continuar.
Nas caixas de diálogo a seguir, selecione o model e a Análise do Looker que você quer usar na consulta e clique em Conectar.
Quando as Planilhas se conectam à sua instância do Looker, as Planilhas abrem uma nova página que mostra a estrutura da Análise selecionada, incluindo visualizações, dimensões, medidas e qualquer descrição de campo que tenha sido adicionada pelo desenvolvedor do Looker.
Criação de consultas do Looker usando as Planilhas Google
As consultas do Looker são criadas usando uma tabela dinâmica das Planilhas Google. Para adicionar dados do Looker à sua planilha:
Na página que mostra a opção "Explorar", selecione Tabela dinâmica.
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 será criada, e a janela Editor da tabela dinâmica será aberta. Você pode adicionar linhas, colunas, valores e filtros para criar sua consulta com base nas dimensões e medidas da Análise do Looker.
As linhas, colunas, valores e filtros no editor dinâmico são equivalentes às dimensões e medidas do Looker das seguintes maneiras:
- As linhas são equivalentes às dimensões do Looker.
- Elas são equivalentes às dimensões dinâmicas do Looker.
- Os valores são equivalentes às medidas do Looker. Para criar uma medida personalizada, selecione uma dimensão do Looker e a função Resumir por do app Planilhas.
- Os filtros são equivalentes aos filtros do Looker.
O editor dinâmico também mostra uma lista das visualizações que fazem parte da Análise, que pode ser selecionada para mostrar as dimensões e medidas incluídas.
Selecione Adicionar para incluir uma linha, coluna, valor ou filtro. O recurso 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 para sua linha, coluna, valor ou filtro.
Depois de adicionar os campos e filtros do Looker para criar a consulta, selecione Aplicar. Isso vai preencher a planilha com dados da sua instância do Looker.
Depois de adicionar os dados do Looker a uma tabela dinâmica, você pode usar as Planilhas Google para formatar os dados ou criar novas fórmulas do app Planilhas com base nesses dados.
Opções de filtragem
Desde o lançamento das páginas conectadas para o Looker, adicionamos novas opções de filtro.
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 vendo uma lista de valores e marcando e desmarcando os de interesse. Antes, era necessário digitar os valores de 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 o app Planilhas vai buscar os 500 valores mais frequentes do Looker.
Você pode pesquisar os itens, selecionar ou limpar todos ou classificar os itens por frequência ou ordem alfabética. Quando você clica em OK na parte inferior, o Planilhas Google armazena suas escolhas. Clique em Aplicar para atualizar a tabela dinâmica normalmente com o novo filtro.
Filtros que usam expressões de filtro do Looker: adicionados em setembro de 2023
É possível aplicar filtros de data relativas 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 "estão nos últimos 30 minutos" ou "está nos últimos 10 dias" nas páginas conectadas.
Para usar expressões de filtro do Looker:
Adicione um campo à seção de filtros da tabela dinâmica.
Clique no menu suspenso Status para exibir as opções de filtro e selecione Expressão de filtro.
Insira qualquer expressão de filtro do Looker no campo Valor.
Por exemplo, para filtrar os últimos sete dias, você pode escrever "7 dias" ou "últimos 7 dias".
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 de filtro: adicionado em outubro de 2023
Agora você pode usar parâmetros e campos somente 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 no app Planilhas, assim como no Looker. Para usá-los, siga estas etapas:
- Adicione ou arraste os parâmetros selecionados e os campos somente de filtro para a seção Filtros, assim como você faria para filtrar uma dimensão ou medida.
- Para parâmetros com valores permitidos, esses valores são exibidos em um menu suspenso na caixa de diálogo Filtrar por condição.
- Para campos somente para filtros, use a caixa de diálogo Filtrar por condição. Se o campo tiver sugestões definidas no modelo do Looker, também será possível usar o recurso filtrar por valor.
Atualizando seus dados no Planilhas Google
Os dados em sua 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 as informações mais atuais.
Tanto a tabela dinâmica quanto a página com o recurso "Explorar" mostram o horário da última atualização.
Selecione Atualizar para atualizar os dados em sua tabela dinâmica.
Programar tempos de atualização regulares
Para programar atualizações automáticas dos seus dados, selecione o menu de três pontos na sua tabela dinâmica e Opções de atualização ou selecione Opções de atualização na página "Explorar". O Looker mostra a caixa de diálogo Atualização programada.
Como editar as configurações de sua tabela dinâmica
Para modificar as linhas, colunas, valores ou filtros 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.
Como 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 no Explorar Histórico sempre que uma nova consulta é executada.
No grupo de campos Propriedades do cliente da API Query, há três novos campos para as páginas conectadas:
- Nome do cliente da API: esse campo sempre mostra
Connected Sheetspara identificar entradas das páginas conectadas. - ID da planilha das páginas conectadas: esse campo mostra o ID da página, que está incluído no URL do app Planilhas Google.
- Acionador das páginas conectadas: mostra se a consulta foi acionada por um usuário que seleciona o botão Atualizar no app Planilhas ou por uma atualização programada.
Este é um exemplo de um 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
Informações úteis
- A diferenciação de maiúsculas e minúsculas para os dados mostrados na tabela dinâmica é determinada pela configuração de diferenciação de maiúsculas e minúsculas do modelo. No entanto, os filtros da tabela dinâmica não diferenciam maiúsculas de minúsculas em situações em que eles não diferenciam maiúsculas de minúsculas em dados nativos do app Planilhas.
- Qualquer pessoa com acesso de Leitor à página pode ver os dados armazenados em cache em uma tabela dinâmica.
- Além de ter acesso de Editor à página, qualquer usuário que precisar editar ou atualizar a tabela dinâmica vai precisar das permissões corretas no Looker para acessar o modelo de dados. Isso inclui acesso ao modelo em que a tabela dinâmica se baseia, permissões para visualizar os dados e acesso adequado aos dados por meio de filtros ou concessõ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 linhas e dados nas 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 contiver mais linhas, o Planilhas mostrará um erro ao usuário. Se o usuário não tiver a permissão download_without_limit, o resultado será truncado para no máximo 5.000 linhas,independentemente do limite do Planilhas.
Além disso, as consultas das páginas conectadas estão sujeitas a um limite de tamanho de dados. Consultas que retornam dados em excesso também resultam em erro.
Se você receber um desses erros, considere adicionar filtros ou usar menos dimensões e/ou menos granulares na consulta.
Solução de problemas das páginas conectadas
Talvez você tenha 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 conectar à sua instância do Looker. Tente de novo. 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 sua instância do Looker e tente se conectar de novo.
- Não foi possível conectar as Planilhas Google à 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 de administração 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 a qualificação.
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 está hospedada no Looker. Conectar-se a uma instância diferente hospedada pelo Looker.
Nenhum modelo aparece após a conexão com uma instância do Looker
Isso indica que você não tem as permissões necessárias para exibir modelos na sua instância.
Um usuário do Looker com o papel de leitor não tem permissões suficientes para criar conexões nas Planilhas, porque não tem permissões suficientes para usar a interface "Explorar" no Looker. Se o usuário quiser usar as páginas conectadas para o Looker, ele precisará ter a permissão explore. As funções "Administrador", "Desenvolvedor" e "Usuário" incluem a permissão explore. Um administrador do Looker pode conceder ao usuário a permissão explore, que deve permitir que ele confira modelos na instância.
Erro: o endereço de e-mail da sua conta vinculada do Looker é diferente do endereço da sua Conta do Google.
Isso indica que o endereço de e-mail da sua conta do Looker não corresponde ao endereço usado na sua Conta do Google. Verifique se você fez login em uma Conta do Google com um endereço de e-mail que corresponde à sua conta do Looker. Um administrador do Looker também pode criar uma conta de usuário do Looker com seu endereço de e-mail atual do Google.
Erro: Solicitação inválida: nenhum cliente de ativação encontrado.
Esse erro indica que o conector das páginas conectadas não foi ativado. Um administrador do Looker precisa ativar os Conectores de BI do Looker ou o botão de alternância Páginas conectadas no painel Conectores de BI na seção Plataforma do menu Administrador do Looker.
Erro: 403 Forbidden
Se a instância do Looker tiver uma lista de permissões de IP configurada, essa lista poderá impedir que as Planilhas se conectem à API Looker. Para descobrir se a causa disso é a lista de permissões, acesse o URL da instância do Looker para confirmar se você recebe um erro Endereço IP não está na lista de permissões.