Como usar as páginas conectadas para o Looker

Com as páginas conectadas para o Looker, os usuários podem analisar dados de modelos LookML de forma interativa na interface conhecida do Google Planilhas. Os usuários do Planilhas terão acesso a dados controlados de mais de 50 bancos de dados do Looker. A análise é intuitiva, já que as páginas conectadas apresentam uma visualização organizada do modelo com visualizações, campos e medidas, exatamente como foram definidos no Looker. Os dados do Looker no 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, sua instância precisa atender aos seguintes requisitos:

  • No Looker (original), o administrador precisa ativar o cliente pré-configurado das Páginas Conectadas na guia Biblioteca de aplicativos da página Gerenciar clientes OAuth (Administrador > Autenticação > Gerenciar clientes OAuth) ou ativar a opção Todos os conectores de BI do Looker ou Google Planilhas no painel Conectores de BI na seção Plataforma do menu Administrador do Looker. No Looker (Google Cloud Core), essas opções estão ativadas por padrão.
  • Sua instância do Looker (original) precisa ser hospedada pelo Looker.
  • Se a instância do Looker (original) tiver uma lista de permissões de IP configurada, será necessário desativá-la para usar as páginas conectadas. Não há uma lista estática específica ou selecionada de endereços IP do Google Planilhas que possa ser adicionada à lista de permissões.
  • No Looker (Google Cloud Core), as Páginas Conectadas são ativadas por padrão. No entanto, se você estiver usando uma instância do Looker (Google Cloud Core) com uma lista de permissões de IP configurada, a caixa de seleção Vincular serviços do Google a esta instância precisa estar marcada na guia Detalhes da página Instância no console do Google Cloud para se conectar às páginas conectadas.
  • Cada usuário que quiser se conectar à sua instância do Looker pelo Google Planilhas precisa usar o mesmo endereço de e-mail na conta de usuário do Looker e 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 ao tentar se conectar ao Looker pelo Planilhas.
  • O acesso aos serviços que não são controlados individualmente precisa ser ativado no Admin Console do Google Workspace. Isso geralmente é ativado 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 a um Look no Google Planilhas

No Looker, um Look é uma consulta única que foi salva anteriormente. É possível adicionar os resultados de um Look a uma planilha e interagir com a saída do Look no app Planilhas.

  1. No menu Dados do Google Planilhas, 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 à qual você se conectou recentemente e selecione Conectar ao Look.

  3. Na caixa de diálogo, selecione o Look que você quer adicionar ao Google Planilhas e clique em Conectar. Use o campo Pesquisar um Look para pesquisar um Look salvo por nome ou ID ou filtre a lista de Looks exibidos na caixa de diálogo inserindo uma substring contida no nome do Look.

  4. Na caixa de diálogo Conectar a um Look, selecione se você quer criar uma nova página para a saída do Look ou adicionar a saída a uma página atual e selecione Criar.

Quando as Planilhas se conectarem à sua instância do Looker, elas vão adicionar a saída do Look selecionado.

Não é possível editar Looks nas Planilhas, mas você pode atualizar os dados deles a qualquer momento clicando em Atualizar. Clique no URL do Look para abrir o Look no Looker. Você também pode conferir o nome, o ID e o URL do Look na barra lateral.

Como se conectar a uma Análise do Looker no Google Planilhas

Uma Análise é o ponto de partida para as consultas. Uma Análise mostra um conjunto especificado de campos do arquivo de visualização associado, e esses campos podem ser selecionados para criar uma consulta em uma página.

  1. No menu Dados do Google Planilhas, 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 à qual você se conectou recentemente e selecione Conectar à Análise.

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

Quando as Planilhas se conectarem à sua instância do Looker, elas vão abrir uma nova página que mostra a estrutura da Análise selecionada, incluindo visualizações, dimensões, medições e todas as descrições de campo adicionadas pelo desenvolvedor do Looker.

Como criar consultas do Looker usando o Google Planilhas

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

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

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

    Uma nova tabela dinâmica vazia é criada, e a janela Editor de tabela dinâmica é aberta. É possível adicionar linhas, colunas, valores e filtros para criar sua consulta com base nas dimensões e medições da Análise 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 dinâmicas do Looker.
    • Os valores são equivalentes às medições do Looker. Para criar uma medição personalizada, selecione uma dimensão do Looker e uma função Resumir por das Planilhas.
    • Os filtros são equivalentes aos filtros do Looker.

    O editor de tabelas dinâmicas também mostra uma lista das visualizações que fazem parte da Análise. Você pode selecionar uma delas para mostrar as dimensões e medições incluídas.

  3. Selecione Adicionar para incluir uma linha, coluna, valor ou filtro. As páginas conectadas mostram uma lista das visualizações disponíveis na Análise. 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.

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

Depois de adicionar os dados do Looker a uma tabela dinâmica, use o Planilhas Google para formatar os dados ou criar novas fórmulas com base neles.

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

É 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 ou desmarcar os valores de interesse. Antes, era necessário digitar os valores de filtro manualmente ao usar a filtragem por 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.

Em seguida, você pode pesquisar entre os itens, selecionar ou limpar todos ou classificar os itens por frequência ou em ordem alfabética. Quando você clicar em OK na parte de baixo, o app vai armazenar suas escolhas. Em seguida, clique em Aplicar para atualizar a tabela dinâmica normalmente, com o novo filtro aplicado.

Filtros que usam expressões de filtro do Looker

É possível aplicar filtros de data relativa, além de muitos outros filtros avançados, nas Páginas Conectadas usando as expressões de filtro do Looker. Por exemplo, é possível aplicar filtros como "está nos últimos 30 minutos" ou "está 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 7 dias, escreva "7 dias" ou "últimos 7 dias".

  4. Clique em OK.

Além da filtragem de datas relativas, 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 ver todas as expressões de filtro disponíveis, consulte a página de documentação Expressões de filtro do Looker.

Como usar parâmetros do Looker e campos somente para filtros

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 campos nas Planilhas, assim como no Looker. Para usá-los, siga estas etapas:

  1. Adicione ou arraste os parâmetros e campos somente para filtro selecionados para a seção Filtros, como 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 de filtro, use a caixa de diálogo Filtrar por condição. Se o campo tiver sugestões definidas no modelo do Looker, você também poderá usar o recurso filtrar por valor.

Como atualizar seus dados no Google Planilhas

Os dados na tabela dinâmica são estáticos, mas podem ser atualizados a qualquer momento. Ao atualizar os dados, o Looker vai consultar seu banco de dados e atualizar a tabela dinâmica com os dados mais recentes.

Tanto a tabela dinâmica quanto a planilha que mostra o Look ou a Análise exibem o horário em que foram atualizados pela última vez.

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

Programar 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, em seguida, Opções de atualização ou selecione Opções de atualização na planilha de análise. O Looker exibe a caixa de diálogo Atualização programada.

Editar as configurações da tabela dinâmica

Para modificar quais linhas, colunas, valores ou filtros estã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 de edição da tabela dinâmica.

Monitorar as 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 de consulta na Análise do histórico de atividades do sistema. Uma entrada é criada na Análise 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 página, que está incluído no URL do Google Planilhas.
  • Acionador das páginas conectadas: esse campo mostra se a consulta foi acionada por um usuário que selecionou o botão Atualizar nas páginas ou por uma atualização programada.

Veja 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 Páginas Conectadas

O suporte da API para as Páginas Conectadas do Looker está disponível nas APIs AppsScript e Google Sheets.

Algumas das ações que você pode realizar de forma programática com o suporte da API incluem:

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

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

Informações importantes

  • A diferenciação de maiúsculas e minúsculas para os dados mostrados na tabela dinâmica é determinada pela configuração que diferencia maiúsculas de 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 de minúsculas para dados nativos do Planilhas.
  • Qualquer pessoa com acesso de leitor à planilha poderá ver os dados armazenados em cache em uma tabela dinâmica.
  • Além do acesso de Editor à planilha, todos os usuários que precisarem editar ou atualizar a tabela dinâmica vão 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 de acesso ou concessões de acesso.
  • Se o usuário estiver se autenticando com o 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 das páginas conectadas

As consultas criadas com as páginas conectadas têm um limite máximo de 100.000 linhas. Se o resultado da consulta tiver mais linhas, as Planilhas vão 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 das Planilhas.

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

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

Solução de problemas das páginas conectadas

Talvez você encontre alguns problemas ao tentar se conectar ao Looker pelo Google Planilhas. Nesta seção, descrevemos esses problemas e como corrigi-los.

Erro: ocorreu um erro ao conectar à sua instância do Looker. Tente novamente. Se o problema continuar, 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 novamente.
  • O Planilhas não consegue se conectar à API Looker. Isso pode ocorrer se a instância do Looker não estiver usando o URL padrão do host da API. Para corrigir isso, deixe o campo URL do host da API no painel de admin da API em branco.

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

Esse erro pode ocorrer por vários motivos:

  • Você está tentando se conectar a uma instância do Looker recém-criada. 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. Conectar-se a outra instância hospedada pelo Looker.

Nenhum modelo aparece depois de se conectar 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 o papel 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. Os papéis de administrador, desenvolvedor e usuário incluem a permissão explore. Um administrador do Looker pode conceder ao usuário a permissão explore, o que permite que ele veja os modelos na instância.

Erro: o endereço de e-mail vinculado à sua conta do Looker é diferente do endereço de e-mail 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 de e-mail 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. Como alternativa, um administrador do Looker pode criar uma nova conta de usuário do Looker que use 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 o cliente pré-configurado das Páginas Conectadas na guia Biblioteca de aplicativos da página Gerenciar clientes OAuth (Administrador > Autenticação > Gerenciar clientes OAuth) ou ativar a opção Todos os conectores de BI do Looker ou Google Planilhas 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, ela poderá impedir que as Planilhas se conectem à API Looker. Para determinar se a lista de permissões é a causa, tente acessar o URL da instância do Looker para ver se você recebe um erro Endereço IP não está na lista de permissões.

  • Para instâncias do Looker (original) que usam uma lista de permissões de IP, não há uma lista estática específica ou selecionada de endereços IP do Google Planilhas que possa ser adicionada à lista de permissões. Para usar as páginas conectadas, desative a lista de permissões de IP.
  • Para instâncias do Looker (Google Cloud Core) que usam uma lista de permissões de IP, é necessário marcar a caixa de seleção Vincular serviços do Google a esta instância na guia Detalhes da instância no console do Google Cloud .