Como criar looks e análises detalhadas

Esta página apresenta uma visão geral da entrega de Looks e Análises detalhadas para os destinos de entrega integrados do Looker e para todos os serviços integrados disponíveis para sua instância do Looker. Para informações sobre a programação de painéis, acesse a página de documentação Programação e envio de painéis.

O Agendador do Looker é a janela pop-up em que você configura as configurações de entrega de conteúdo. Para os Looks, você pode usar o Programador para enviar entregas únicas ou recorrentes. As análises detalhadas só podem ser enviadas como entregas únicas. Para programar a entrega recorrente de conteúdo da Análise, primeiro salve-o como um Look.

Se você é um desenvolvedor do Looker, desative o Modo de desenvolvimento para ativar essas opções de programação.

As opções de entrega disponíveis dependem das permissões relacionadas à entrega concedidas pelo administrador do Looker.

Como abrir o Programador em uma pasta

Para as análises, você pode abrir o Programador apenas no Analisar, não em uma pasta.

Para abrir o Programador em uma pasta ou subpasta, encontre a pasta ou subpasta que contém o painel que você quer enviar. Quando você acessa uma pasta, todos os Looks e dashboards dela são listados na visualização em lista ou em grade.

Um ícone de calendário indica que você programou pelo menos uma entrega recorrente para esse conteúdo. Na visualização em grade, passe o cursor sobre a miniatura do conteúdo para ver o ícone de calendário, se houver.

Na visualização de lista, é possível abrir o Programador:

  • Clicar no ícone de calendário de um item, se houver
  • Clicar no menu de três pontos de um item e escolher Editar programação (se já houver uma programação para o item), Adicionar programação (se ainda não houver uma programação para o item) ou Enviar (para criar uma entrega única)
  • Abra o conteúdo, clique no menu de engrenagem no canto superior direito e escolha Agendar (para entregas recorrentes) ou Enviar (para entregas únicas).

Na visualização de grade, é possível abrir o Programador:

  • Clicar no ícone de calendário de um item, se houver
  • Abra o conteúdo, clique no menu de engrenagem no canto superior direito e escolha Agendar (para entregas recorrentes) ou Enviar (para entregas únicas).

Como criar uma entrega

Para criar uma entrega no conteúdo do Looker, abra o Programador legado clicando no menu de engrenagem no canto superior direito do conteúdo e escolhendo Programar (para entregas recorrentes) ou Enviar (para entregas únicas).

Para envios recorrentes, o painel esquerdo do Agendador legado mostra todos os agendamentos criados para o conteúdo e destaca o título do agendamento que você está criando ou editando. O painel esquerdo lista as programações em ordem cronológica inversa, a partir da última atualização. É possível duplicar ou excluir programações clicando no ícone Duplicate ou Delete à direita da programação, respectivamente.

Se esta for a primeira programação que você criar para esse conteúdo, o painel principal vai mostrar as opções de programação definidas com os valores padrão. É possível modificar esses valores conforme necessário. Se você já criou um ou mais agendamentos para esse conteúdo, o painel principal vai mostrar as configurações salvas na parte de cima da lista. Em seguida:

  • Para editar as opções de uma programação, selecione-a e mude as opções conforme necessário. Quando terminar, clique em Salvar tudo.
  • Para criar outras programações para o mesmo conteúdo, clique em Nova e insira as configurações.

Quando terminar, clique em Salvar tudo.

As seções a seguir explicam cada configuração de programação.

Como nomear a entrega

Dê um título exclusivo à programação no campo Dê um nome à sua programação. O título vai aparecer no painel à esquerda depois que você salvar a programação, na lista de programações criadas e nas páginas de gerenciamento de programação no painel Administrador.

Dependendo do destino da entrega, o título também pode aparecer em outros lugares:

  • Para envios por e-mail, o título é usado para o assunto do e-mail e como parte do nome do arquivo se você selecionar um formato que usa um anexo de e-mail.
  • Para webhooks, o título é incluído no payload do webhook no campo Title.
  • Para envios a um bucket do Amazon S3, o título é usado no nome do arquivo do envio e em todos os e-mails de erro enviados. O nome do arquivo da entrega segue o formato TITLE_TIMESTAMP_HASH, em que HASH é um identificador aleatório de seis caracteres e TIMESTAMP segue o padrão YYYY-MM-DDTHHMM. Por exemplo, a parte do carimbo de data/hora seria 2019-05-31T0933 para 31 de maio de 2019 às 9h33. O fuso horário do carimbo de data/hora vai corresponder ao fuso horário de envio da programação.
  • Para envios a serviços integrados que geram um anexo de arquivo, o título é incluído no nome do arquivo do envio.

  • Para envios por SFTP, o título é incluído no nome do arquivo do envio. O nome do arquivo da entrega segue o formato TITLE_TIMESTAMP_TOKEN, em que TOKEN é um identificador aleatório de seis caracteres e TIMESTAMP segue o padrão YYYY-MM-DDTHHMM. Por exemplo, a parte do carimbo de data/hora seria 2019-05-31T0933 para 31 de maio de 2019 às 9h33. O fuso horário do carimbo de data/hora vai corresponder ao fuso horário de envio da programação.

    Para envios por SFTP, apenas caracteres alfanuméricos, sublinhado (_) e hífen (-) são aceitos no nome do arquivo do envio. O Looker remove todos os caracteres que não sejam A-Z, a-z, 0-9, _ ou - do que você digitar no campo Dar um nome à sua programação.

Como escolher o destino da entrega

Dependendo de como o administrador do Looker configurou suas permissões, talvez nem todos os destinos estejam visíveis.

A configuração Para onde esses dados devem ser enviados? pode mostrar várias opções de destino para as entregas de dados. Cada destino oferece opções de envio diferentes.

Os destinos incluem:

Depois de selecionar um destino de dados, um novo campo de configuração vai aparecer para você adicionar detalhes específicos sobre esse destino, como um endereço de e-mail ou um URL de webhook.

Opções de entrega de e-mail

Escolha E-mail na seção Para onde esses dados devem ser enviados?. Seu conteúdo será enviado para uma lista de endereços de e-mail que você especificar.

Na seção Para quem enviar o e-mail, insira os endereços de e-mail dos destinatários. Insira um ou vários endereços de e-mail separados por vírgulas e clique em Adicionar.

Dependendo das configurações da sua instância do Looker e das permissões atribuídas, talvez você possa enviar e-mails para endereços não associados a nenhuma conta de usuário na sua instância do Looker. Eles são classificados como e-mails externos. Para enviar conteúdo a usuários externos, o administrador do Looker precisa conceder a você permissões para enviar conteúdo a usuários externos ou adicionar os domínios de e-mail desses destinatários à lista de permissões de domínios de e-mail para conteúdo programado.

Se um destinatário for outro usuário do Looker, ele vai ter a opção de vincular o painel novamente a partir do e-mail, a menos que o administrador do Looker tenha definido a política de dados por e-mail da sua instância para Enviar apenas dados ou a opção Incluir links estiver desmarcada.

Se todos os destinatários cancelarem a inscrição em uma entrega de e-mail programada, essa programação será excluída do Looker, mesmo nas páginas de gerenciamento de programação para usuários e administradores. Se um destinatário cancelar a inscrição em nome de um grupo de e-mails, nenhum membro do grupo vai receber as entregas de e-mail programadas.

Consulte a seção Como usar opções avançadas de envio nesta página para mais informações sobre envios de e-mail.

Marque a caixa Incluir uma mensagem personalizada para adicionar uma mensagem personalizada no corpo do e-mail. O Looker limita o número de caracteres em uma mensagem personalizada a 1.500.

As entregas por e-mail não podem exceder 20 MB (para formatos enviados no corpo do e-mail) e 15 MB (para formatos enviados como anexo).

Opções de envio para webhooks

Os webhooks são uma maneira cada vez mais comum de acionar trocas entre serviços baseados na Internet. Com um serviço da Web como o Zapier, os webhooks podem permitir que os dados do Looker sejam enviados para uma ampla gama de aplicativos. Por exemplo, você pode programar o envio periódico de um visual ou painel para um webhook. Ao configurar uma entrega, o Looker vai solicitar o endereço do webhook.

Na seção Para onde esses dados devem ser enviados?, escolha Webhook. Na seção URL do webhook, insira o URL para onde o Looker vai enviar uma solicitação HTTPS para essa entrega. Você pode encontrar esse URL no serviço da Web que está usando para processar o webhook. Para configurar um webhook, acesse seu serviço da Web e faça o seguinte:

  1. Receba um URL para o Looker enviar uma solicitação HTTPS.
  2. Especifique um aplicativo de destino para a entrega de dados do Looker. O aplicativo de destino pode exigir mais configurações para receber dados do Looker.

O procedimento exato varia de acordo com o serviço da Web e o aplicativo de destino que você está usando para exibir o painel. Consulte esta postagem da comunidade do Looker sobre Programação de visualizações e painéis usando webhooks (3.46+) para conferir diretrizes sobre como configurar outro aplicativo para receber os dados do webhook do Looker.

O Looker vai tentar fazer a entrega para um webhook por no máximo 30 minutos. Verifique se o destino pode responder à tentativa de envio do webhook em até 30 minutos.

Opções de entrega para buckets do Amazon S3

Os buckets do Amazon S3 são uma maneira comum de armazenar grandes quantidades de dados. Você ou sua empresa precisam ter criado um bucket do S3 com a Amazon para que o Looker possa usá-lo.

Se você escolher a opção de destino do Amazon S3, o Looker vai solicitar outras configurações sobre formatação e sobre o bucket do Amazon S3, conforme descrito nesta página. Consulte esta postagem da Comunidade do Looker sobre Programação de resultados (ilimitados) para o S3 para mais detalhes sobre como enviar dados usando um bucket do Amazon S3.

Na seção Para onde esses dados devem ser enviados?, escolha Amazon S3. A seção Detalhes do S3 aparece e solicita informações sobre seu bucket do Amazon S3:

  • Bucket: o nome do bucket do Amazon S3.
  • Caminho opcional: a pasta em que você quer salvar seus dados, se houver.
  • Chave de acesso: o ID da chave de acesso ao seu bucket do S3, fornecido pela Amazon.
  • Chave secreta: a chave de acesso secreta do bucket do S3, fornecida pela Amazon.
  • Região: a região dos serviços da Amazon em que seu bucket do S3 está hospedado.

Opções de envio para servidores SFTP

Escolha SFTP na seção Para onde esses dados devem ser enviados? para enviar o painel a um servidor SFTP. Enviar os resultados para um servidor SFTP é um bom método quando os dados ou a visualização são muito grandes para serem enviados por e-mail. Se você escolher essa opção de entrega, o Looker vai solicitar o endereço, o nome de usuário e a senha do servidor SFTP, conforme descrito a seguir.

Observe o seguinte sobre as entregas SFTP:

  • Para receber entregas SFTP do Looker, o administrador da rede precisa adicionar os endereços IP do Looker à lista de permissões de IP do servidor SFTP ou às regras de tráfego de entrada.
  • Ao enviar para um servidor SFTP, apenas caracteres alfanuméricos, sublinhado (_) e hífen (-) são aceitos no nome do arquivo. O Looker remove todos os caracteres que não sejam A-Z, a-z, 0-9, _ ou - do que você digitar no campo Dar um nome à sua programação.

Quando você escolhe SFTP, o Looker solicita o URL e as informações de login do servidor:

  • Endereço: o URL ou endereço IP do servidor SFTP para onde você quer enviar os dados. Exemplo:

    • sftp://files.looker.com/Marketing/In/
    • sftp://192.168.0.10/Marketing/In/

    Este exemplo de URL termina com o caractere /. Isso indica que o arquivo será salvo em uma pasta chamada In. Se você deixar o / final de fora, o arquivo será salvo na pasta Marketing e "In" será adicionado ao início do nome do arquivo. Você precisa ter acesso de gravação à pasta em que quer criar o arquivo.

  • Nome de usuário e senha: credenciais de login para o servidor SFTP.

  • Algoritmo de troca de chaves preferido: esse campo é opcional. Para configurar, escolha o algoritmo de troca de chaves SSH preferido para estabelecer a conexão. Veja a seguir as opções aceitas:

    • diffie-hellman-group-exchange-sha1
    • diffie-hellman-group1-sha1
    • diffie-hellman-group14-sha1
    • diffie-hellman-group-exchange-sha256

    Se a conexão não for estabelecida em cinco minutos, escolha outro algoritmo. Alguns algoritmos demoram muito para gerar uma chave SSH. Essa opção permite usar um algoritmo que pode levar menos tempo. A escolha de um dos algoritmos faz com que ele seja o preferido para estabelecer a conexão SSH. Se o algoritmo não tiver suporte do servidor, todos os outros algoritmos serão usados nas tentativas seguintes. Quando esse campo é definido como Padrão, a ordem original dos algoritmos na biblioteca de conexão é usada.

No momento, o suporte a SFTP está limitado a credenciais de nome de usuário e senha. Não há suporte para credenciais de chave privada SSH.

Os algoritmos de chave de host compatíveis com as entregas do SFTP do Looker são:

  • ssh-rsa
  • ssh-dss
  • ssh-rsa-cert-v01@openssh.com
  • ssh-rsa-cert-v00@openssh.com

O Looker armazena impressões digitais SFTP para seu servidor SFTP. Se você encontrar erros na entrega do SFTP, isso pode indicar que as impressões digitais do SFTP estão inválidas. Nesse caso, entre em contato com o administrador do Looker.

Se você receber o erro Java::JavaLang::NullPointerExceptions ao enviar dados para um servidor SFTP, isso pode ser devido a um bug no JRuby que impede o uso de algoritmos de curva elíptica (EC) ou chaves de host para conexões SSH do Looker para destinos SFTP. Para evitar problemas com o envio de dados para destinos SFTP, não use algoritmos EC nos arquivos ~/.ssh/config ou /etc/ssh_config nem armazene chaves de host EC em ~/.ssh no host do Looker.

O Looker faz upload do arquivo para o diretório especificado no servidor SFTP usando a seguinte convenção para o nome do arquivo:

<name>_<timestamp>_<token>.<file extension>
  • O nome que você informou no campo Dar um nome à sua programação, depois que o Looker remove todos os caracteres, exceto A-Z, a-z, 0-9, _ ou -
  • O carimbo de data/hora em que a programação foi enviada, no formato %Y-%m-%dT%H%M
  • Um token que consiste em uma string aleatória de seis caracteres
  • A extensão do arquivo

Por exemplo: Test_Schedule_2019-04-11T1130_HWkvys.csv

Opções de envio para integrações de terceiros

É possível programar ou enviar uma Análise ou os resultados de uma Análise detalhada para um serviço integrado ao Looker, como Slack, Dropbox, Google Drive e outros. As integrações precisam ser ativadas pelo administrador do Looker. Os administradores do Looker precisam conceder permissões especificamente para que usuários e usuários incorporados enviem e programem dados para integrações de terceiros.

Quando um serviço integrado é selecionado no campo Destino do Programador, vários campos novos podem aparecer e solicitar mais informações.

A lista a seguir mostra os serviços do Hub de Ações da Looker para os quais você pode enviar uma Análise ou os resultados de uma Análise detalhada.

Confira como usar a lista:

  • Os URLs mostrados na coluna Link to README file (link para o arquivo README) fornecem instruções para ativar e configurar o serviço integrado para funcionar com o Looker.
  • Os URLs mostrados na coluna Como usar essa integração fornecem instruções sobre como enviar dados do Looker para o serviço integrado. Alguns desses artigos também contêm instruções de ativação.
  • Tags obrigatórias do LookML lista todas as tags obrigatórias que precisam ser usadas com o parâmetro tags no modelo subjacente do conteúdo.
  • Tipo de ação: indica o nível de dados que o serviço integrado está enviando: campo, consulta ou painel. Uma ação no nível do campo envia o valor de uma única célula especificada em uma tabela de dados. Uma ação no nível da consulta envia os resultados de uma consulta inteira, como todas as linhas em uma Análise detalhada ou um Look. Uma ação no nível do painel envia uma imagem de um painel.
  • Usar a autenticação do Google OAuth indica se o serviço integrado usa credenciais do Google OAuth para autenticação.
  • Uso de streaming de dados: indica se o serviço integrado oferece suporte a resultados de consulta transmitidos por streaming.
Serviço integrado Descrição Link para o arquivo README Como usar essa integração Tags do LookML obrigatórias Tipo de ação Usa a autenticação OAuth do Google (Sim/Não) Usa streaming de dados (sim/não)
Airtable Adicione registros a uma tabela no Airtable. Conferir o README no GitHub Conferir o artigo da Comunidade Nenhum Consulta Não Não
Amazon SageMaker Infer Faça uma inferência usando o Amazon SageMaker. Nenhum README disponível Nenhum artigo disponível Nenhum Consulta Não Sim
Treinamento do Amazon SageMaker: aprendiz linear Inicie um job de treinamento no Amazon SageMaker usando o algoritmo de aprendizagem linear. Nenhum README disponível Nenhum artigo disponível Nenhum Consulta Não Sim
Amazon SageMaker Train: Xgboost Inicie um job de treinamento no Amazon SageMaker usando o algoritmo XGBoost. Nenhum README disponível Nenhum artigo disponível Nenhum Consulta Não Sim
Instância de interrupção do EC2 da Amazon Web Services Pare uma instância do EC2 usando a API Amazon EC2. Conferir o README no GitHub Conferir o artigo da Comunidade aws_resource_id Campo, consulta Não Não
Trado Usa o resultado da consulta para criar um modelo preditivo. Conferir o README no GitHub Consulte o README Nenhum Consulta Não Sim
Armazenamento do Azure Envie e armazene um arquivo de dados no Azure Storage. Conferir o README no GitHub Conferir o artigo da Comunidade Nenhum Consulta Não Sim
Braze A ação do Braze permite sinalizar usuários no Braze usando o endpoint da API REST de uma pesquisa. Verifique se há um campo braze_id marcado nos resultados. EXPORTAÇÃO MÁXIMA: 10.000. Conferir o README no GitHub Consulte o README braze_id Consulta Não Sim
DataRobot Envie dados para o DataRobot e crie um novo projeto. Conferir o README no GitHub Consulte o README Nenhum Consulta Não Sim
DigitalOcean: parar o Droplet Pare o processo da DigitalOcean usando a API da DigitalOcean. Conferir o README no GitHub Conferir o artigo da Comunidade digitalocean_droplet_id Campo, consulta Não Não
Espaços da DigitalOcean Enviar e armazenar um arquivo de dados no DigitalOcean Storage. Conferir o README no GitHub Conferir o artigo da Comunidade Nenhum Consulta Não Sim
Dropbox Enviar e armazenar um arquivo de dados no Dropbox. Nenhum README disponível Consulte a documentação Nenhum Consulta Sim Não
Públicos-alvo personalizados do Facebook Faça upload de dados para os públicos personalizados do Facebook Ads usando a lista de clientes. Conferir o README no GitHub Consulte o README Nenhum Consulta Sim Sim
Firebase Use o Firebase para enviar notificações push para dispositivos móveis. Nenhum README disponível Nenhum artigo disponível Nenhum Consulta Não Não
segmento de público-alvo por lista de clientes do Google Ads Faça upload de dados para a Segmentação por lista de clientes do Google Ads. Conferir o README no GitHub Consulte a documentação Nenhum Consulta Sim Sim
Importação de dados do Google Analytics Faça upload de dados para um conjunto de dados do Google Analytics. Conferir o README no GitHub Consulte o README Nenhum Consulta Sim Sim
Google Cloud Storage Grave arquivos de dados em um bucket do Google Cloud Storage. Conferir o README no GitHub Conferir o artigo da Comunidade Nenhum Consulta Não Sim
Google Drive Enviar dados para o Google Drive. Nenhum README disponível Consulte a documentação Nenhum Consulta Sim Sim
Planilhas Google Enviar dados CSV para uma planilha Google. Nenhum README disponível Consulte a documentação Nenhum Consulta Sim Sim
Empresas do Hubspot Adicione propriedades às suas empresas usando a API Hubspot V3. Conferir o README no GitHub Consulte o README hubspot_company_id Consulta Não Sim
Contatos do HubSpot Adicione propriedades aos seus contatos usando a API Hubspot V3. Conferir o README no GitHub Consulte o README hubspot_contact_id Consulta Não Sim
Kloudio Adicione dados a uma planilha Google. Conferir o README no GitHub Consulte o README Nenhum Consulta Não Não
mParticle Exporte em massa os dados de usuários ou eventos do Looker para o mParticle. Conferir o README no GitHub Consulte o README Consulte o README Consulta Não Sim
Campanhas do Salesforce Adicione contatos ou leads à campanha do Salesforce. Conferir o README no GitHub Consulte o README sfdc_contact_id ou sfdc_lead_id Consulta Sim Não
Grupo de segmentos Adicione características e/ou usuários aos seus grupos de segmentos. Conferir o README no GitHub Consulte a documentação segment_group_id e user_id ou segment_group_id e segment_anonymous_id Consulta Não Sim
Segment Identify Adicione características aos usuários da sua segmentação usando a API Identify. Conferir o README no GitHub Consulte a documentação email ou user_id ou segment_anonymous_id ou segment_group_id Consulta Não Sim
Trilha do segmento Conecte-se a várias integrações fornecidas pelo Segment para identificar e segmentar usuários para fluxos de trabalho de marketing. Conferir o README no GitHub Consulte a documentação email ou user_id ou segment_anonymous_id ou segment_group_id Consulta Não Sim
SendGrid Envie dados e programe o envio de resultados para um endereço de e-mail usando a API do SendGrid. Conferir o README no GitHub Conferir o artigo da Comunidade Nenhum Consulta Não Não
Slack Envie conteúdo do Looker em mensagens diretas, canais públicos e particulares no Slack usando o OAuth. Ele está disponível para implantações hospedadas pelo Looker na versão 6.24 ou mais recente com o recurso Lista de permissões de IP desativado. Nenhum README disponível Consulte a documentação Nenhum Consulta Sim Sim
Apêndice do Slack (token de API) Envie dados diretamente para um canal do Slack com as credenciais do usuário. Consulte também a documentação do Lookerbot para conferir outras funcionalidades do Slack. Conferir o README no GitHub Consulte a documentação Nenhum Consulta Não Não
Teams: webhook de entrada Envie dados para o Microsoft Teams usando um webhook de entrada. Conferir o README no GitHub Consulte o README Nenhum Consulta Não Não
Bandeja Conecte-se a várias integrações fornecidas pelo Tray.io para automatizar fluxos de trabalho. Conferir o README no GitHub Conferir o artigo da Comunidade Nenhum Consulta Não Sim
Twilio: enviar dados Envie dados de uma pesquisa ou de uma programação para um número de telefone usando a API do Twilio. Conferir o README no GitHub Conferir o artigo da Comunidade Nenhum Consulta Não Não
Twilio: enviar mensagem Envie uma mensagem para uma série de números de telefone (colunas de dados marcadas como números de telefone) em uma Análise. Conferir o README no GitHub Consulte o README telefone Campo, consulta Não Não
Zapier Conecte-se a várias integrações fornecidas pelo Zapier para automatizar fluxos de trabalho. Conferir o README no GitHub Conferir o artigo da Comunidade Nenhum Consulta Não Sim

Como escolher o formato de dados

Para envios por e-mail, a opção de selecionar um formato de dados não estará disponível se o administrador do Looker tiver definido a política de dados por e-mail da sua instância do Looker como Enviar apenas o link.

Os Looks e os Insights apresentam opções de formatação diferentes dependendo do destino de entrega. Para escolher o formato da entrega, selecione o ícone apropriado na seção Formatar dados como do Programador.

Consulte a tabela a seguir para saber como cada formato é veiculado para cada destino.

Formato E-mail Webhook Amazon S3 SFTP
Tabela de dados A tabela de dados no corpo do e-mail em formato HTML Indisponível para este destino Indisponível para este destino Indisponível para este destino
Visualização A visualização no corpo do e-mail como uma imagem PNG Indisponível para este destino Indisponível para este destino Indisponível para este destino
CSV A tabela de dados como um anexo de arquivo de texto separado por vírgulas A tabela de dados como um anexo de arquivo de texto separado por vírgulas A tabela de dados como um anexo de arquivo de texto separado por vírgulas A tabela de dados como um anexo de arquivo de texto separado por vírgulas
XLSX A tabela de dados como um anexo de arquivo do Excel A tabela de dados como um anexo de arquivo do Excel A tabela de dados como um anexo de arquivo do Excel A tabela de dados como um anexo de arquivo do Excel
JSON — Simples A tabela de dados como um anexo de arquivo JSON. Nesse formato, o Looker usa o nome de um campo de dimensão ou métrica como o valor renderizado em vez do rótulo do campo. A tabela de dados como um anexo de arquivo JSON. Nesse formato, o Looker usa o nome de um campo de dimensão ou métrica como o valor renderizado em vez do rótulo do campo. A tabela de dados como um anexo de arquivo JSON. Nesse formato, o Looker usa o nome de um campo de dimensão ou métrica como o valor renderizado em vez do rótulo do campo. A tabela de dados como um anexo de arquivo JSON. Nesse formato, o Looker usa o nome de um campo de dimensão ou métrica como o valor renderizado em vez do rótulo do campo.
JSON: rótulo Indisponível para este destino A tabela de dados no formato JSON. Nesse formato, o Looker usa rótulos de campo como o valor renderizado na saída JSON. Indisponível para este destino Indisponível para este destino
JSON — Simples, Inline Indisponível para este destino A tabela de dados enviada diretamente no formato JSON. Nesse formato, o Looker usa o nome de um campo de dimensão ou métrica como o valor renderizado em vez do rótulo do campo. Indisponível para este destino Indisponível para este destino
JSON — Detalhado, Inline Indisponível para este destino A tabela de dados enviada diretamente no formato JSON, com detalhes adicionais, como metadados de campo, informações de cache, o horário em que a consulta foi concluída e quanto tempo ela levou para ser executada. Nesse formato, o Looker usa o nome de um campo de dimensão ou métrica como o valor renderizado em vez do rótulo do campo. A tabela de dados enviada diretamente no formato JSON, com detalhes adicionais, como metadados de campo, informações de cache, o horário em que a consulta foi concluída e o tempo que a consulta levou para ser executada. Nesse formato, o Looker usa o nome de um campo de dimensão ou métrica como o valor renderizado em vez do rótulo do campo. A tabela de dados enviada diretamente no formato JSON, com detalhes adicionais, como metadados de campo, informações de cache, o horário em que a consulta foi concluída e quanto tempo ela levou para ser executada. Nesse formato, o Looker usa o nome de um campo de dimensão ou métrica como o valor renderizado em vez do rótulo do campo.
Texto A tabela de dados como um anexo de arquivo de texto delimitado por tabulação A tabela de dados como um anexo de arquivo de texto delimitado por tabulação A tabela de dados como um anexo de arquivo de texto delimitado por tabulação A tabela de dados como um anexo de arquivo de texto delimitado por tabulação
HTML A tabela de dados como um anexo de arquivo HTML A tabela de dados como um anexo de arquivo HTML A tabela de dados como um anexo de arquivo HTML A tabela de dados como um anexo de arquivo HTML

Acionar a entrega

Essa opção não vai aparecer se você enviar um conteúdo para a seção "Explorar" ou um look único.

Ao programar entregas recorrentes, você tem duas opções para acionar as entregas:

Como especificar o gatilho do datagroup

Essa opção não vai aparecer se você enviar uma Análise, uma entrega única de um Look ou se tiver especificado um acionador de intervalo recorrente para a entrega recorrente.

Para usar um gatilho de grupo de dados, selecione Atualização de grupo de dados na seção Gatilho do Programador. Em seguida, escolha o grupo de dados de origem no menu suspenso Selecionar grupo de dados.

Para programar conteúdo usando um acionador de grupo de dados, o arquivo de modelo em que o conteúdo é baseado precisa incluir um grupo de dados. O Looker lista todos os grupos de dados definidos nos modelos incluídos no bloco do Look ou do painel, mesmo que eles não sejam usados para lidar com o armazenamento em cache de consultas ou PDTs.

Os agendamentos com base em grupos de dados só são acionados para envio depois que o processo de regeneração é concluído para todos os PDTs que são mantidos com esse grupo, garantindo que o envio inclua os dados mais atualizados.

Como especificar a recorrência de envio

Essa opção não vai aparecer se você enviar uma Análise detalhada, uma entrega única de um Look ou se tiver especificado um acionador de atualização de grupo de dados para a entrega recorrente.

Para entregas que usam um intervalo recorrente, é possível personalizar o horário da sua programação na seção Entregar essa programação. Selecione Intervalo recorrente na seção Acionar do Agendador. As opções de tempo mudam dependendo se você escolhe Diário, Semanal, Mensal, Por hora ou Por minuto. É possível ajustar o fuso horário da programação na seção Opções avançadas.

O horário de término dos intervalos Por hora e Por minuto não é incluído. A última entrega será enviada no último intervalo selecionado antes do horário de término especificado. Por exemplo, se o conteúdo for programado A cada hora entre 12h e 23h, ele será enviado no horário, a cada hora, entre 12h e 22h. Se o conteúdo for programado A cada minuto a cada 30 minutos entre 12h e 23h, o último envio nesse período será às 22h30.

Como aplicar filtros à entrega

Essa opção não vai aparecer se você enviar uma pesquisa.

Se você estiver exibindo um Look ou painel com filtros, poderá modificar as condições de filtro para filtrar ainda mais os resultados.

Clique em Filtros para conferir e modificar os filtros associados a esse visual ou painel para sua entrega. Mudar essas opções de filtro no Programador não altera os filtros no seu visual ou painel. Se um filtro do painel exigir um valor de filtro e o filtro da programação estiver em branco, a programação não vai mostrar resultados após a entrega.

Se você mudar os nomes de campos que servem como filtros nos seus Looks ou painéis, revise a seção Filtros dos seus Looks e painéis programados e atualize os filtros conforme necessário para refletir as mudanças. Se uma entrega de conteúdo programada incluir filtros que não funcionam mais (por exemplo, se o campo referenciado foi alterado), a entrega programada poderá expor dados não filtrados.

Para personalizar ainda mais as entregas, use a opção de filtro corresponde a um atributo do usuário (se os administradores do Looker configuraram valores específicos do usuário chamados de atributos do usuário). A configuração de um filtro em um desses atributos personaliza automaticamente os resultados para cada usuário. Isso significa que você pode enviar resultados personalizados para muitos usuários, mesmo que envie uma entrega única. Leia mais sobre isso na página de documentação Atributos do usuário.

Como aplicar opções avançadas de entrega

A seção Opções avançadas oferece mais personalização para sua entrega. Clique na seta ao lado de Opções avançadas para abrir o menu. As opções disponíveis dependem do destino e do formato selecionados e se você está enviando um painel, uma Análise ou uma Análise detalhada. Os links na tabela a seguir direcionam a uma descrição de cada opção disponível para entregas de Looks ou Análises para os destinos integrados do Looker. As entregas para integrações de terceiros podem ter opções avançadas exclusivas disponíveis.

Formato E-mail Webhook Amazon S3 SFTP
Tabela de dados
Enviar esta programação se Não disponível para este destino Não disponível para este destino Não disponível para este destino
Limite
Opções de e-mail Executar programação como destinatário
Incluir links
Opções de formatação Aplicar opções de visualização
Valores de dados formatados
Fuso horário
Visualização
Limite Não disponível para este destino Não disponível para este destino Não disponível para este destino
Opções de e-mail Executar programação como destinatário
Incluir links
Resolução da tabela
Fuso horário
CSV
Enviar esta programação se Enviar esta programação se Enviar esta programação se Enviar esta programação se
Limite Limite Limite Limite
Opções de e-mail Executar programação como destinatário Não disponível para este destino Não disponível para este destino Não disponível para este destino
Incluir links
Opções de formatação Aplicar opções de visualização Opções de formatação Aplicar opções de visualização Opções de formatação Aplicar opções de visualização Opções de formatação Aplicar opções de visualização
Valores de dados formatados Valores de dados formatados Valores de dados formatados Valores de dados formatados
Fuso horário Fuso horário Fuso horário Fuso horário
XLSX
Enviar esta programação se Enviar esta programação se Enviar esta programação se Enviar esta programação se
Limite Limite Limite Limite
Opções de e-mail Executar programação como destinatário Não disponível para este destino Não disponível para este destino Não disponível para este destino
Incluir links
Opções de formatação Aplicar opções de visualização Opções de formatação Aplicar opções de visualização Opções de formatação Aplicar opções de visualização Opções de formatação Aplicar opções de visualização
Valores de dados formatados Valores de dados formatados Valores de dados formatados Valores de dados formatados
Fuso horário Fuso horário Fuso horário Fuso horário
JSON — Simples; JSON – Rótulo; JSON — Simples, Inline
Enviar esta programação se Enviar esta programação se Enviar esta programação se Enviar esta programação se
Limite Limite Limite Limite
Opções de e-mail Executar programação como destinatário Não disponível para este destino Não disponível para este destino Não disponível para este destino
Incluir links
Opções de formatação Aplicar opções de visualização Opções de formatação Aplicar opções de visualização Opções de formatação Aplicar opções de visualização Opções de formatação Aplicar opções de visualização
Valores de dados formatados Valores de dados formatados Valores de dados formatados Valores de dados formatados
Fuso horário Fuso horário Fuso horário Fuso horário
JSON — Detalhado, Inline Não disponível para este destino Limite Limite Limite
Não disponível para este destino Fuso horário Fuso horário Fuso horário
Texto
Enviar esta programação se Enviar esta programação se Enviar esta programação se Enviar esta programação se
Limite Limite Limite Limite
Opções de e-mail Executar programação como destinatário Não disponível para este destino Não disponível para este destino Não disponível para este destino
Incluir links
Opções de formatação Aplicar opções de visualização Opções de formatação Aplicar opções de visualização Opções de formatação Aplicar opções de visualização Opções de formatação Aplicar opções de visualização
Valores de dados formatados Valores de dados formatados Valores de dados formatados Valores de dados formatados
Fuso horário Fuso horário Fuso horário Fuso horário
HTML
Enviar esta programação se Enviar esta programação se Enviar esta programação se Enviar esta programação se
Limite Limite Limite Limite
Opções de e-mail Executar programação como destinatário Não disponível para este destino Não disponível para este destino Não disponível para este destino
Incluir links
Opções de formatação Aplicar opções de visualização Opções de formatação Aplicar opções de visualização Opções de formatação Aplicar opções de visualização Opções de formatação Aplicar opções de visualização
Valores de dados formatados Valores de dados formatados Valores de dados formatados Valores de dados formatados
Fuso horário Fuso horário Fuso horário Fuso horário

Envie esta programação se

Para envios recorrentes de looks, é possível personalizar a programação para enviar o conteúdo do look somente quando determinadas condições forem atendidas. Os alertas têm uma função semelhante nos blocos do painel.

No menu suspenso Enviar essa programação se, especifique se você quer enviar o conteúdo do Look apenas se houver resultados, apenas se não houver resultados ou se houver ou não resultados. Por exemplo, é possível usar filtros para criar condições para situações que você quer monitorar, como itens abaixo de uma determinada quantidade no inventário, despesas acima de um determinado valor e assim por diante. Em seguida, envie o conteúdo somente se essa condição for atendida.

Também é possível especificar que a entrega só vai ocorrer se os resultados da consulta tiverem mudado desde a última entrega de dados. Para isso, marque a caixa ao lado de e os resultados mudaram desde a última execução. Essa opção não está disponível se você quiser usar a opção de limite Todos os resultados.

Limite

Para limitar o tamanho da entrega, selecione uma das seguintes opções de limite para seus dados:

  • Resultados na tabela:os dados são enviados em uma única entrega.
  • Todos os resultados:os dados são transmitidos por streaming. Consulte mais informações em Quais são todos os limites de linha no Looker? página de práticas recomendadas). Isso é útil para grandes conjuntos de dados, porque ignora as limitações de tamanho de arquivo, navegador e memória.

Se você escolher Resultados na tabela, o Looker vai obedecer às limitações de linha que você configurou no Look salvo ou na Análise. Se você escolher Todos os resultados, o Looker vai retornar todas as linhas da consulta, independentemente das configurações salvas do Look e do limite típico de 5 mil linhas do Looker. Isso pode ser desejável para recuperar conjuntos de dados muito grandes, mas é preciso ter cuidado para garantir que a consulta não seja muito grande para o banco de dados.

Limitar as opções de e-mail

Ao enviar Looks e Análises, você pode limitar o tamanho do e-mail para não ultrapassar os limites de tamanho do servidor de e-mail. Selecione uma das seguintes opções de limite para seus dados:

  • Resultados na tabela: os dados são enviados com um limite de 5.000 linhas. Essa é a única opção disponível para e-mails que usam as opções de formato Tabela de dados ou Visualização. E-mails com mais de 5.000 linhas não serão enviados.
  • Todos os resultados: se você estiver usando as opções de formato "Texto", CSV, JSON, "Simples", XLSX ou HTML, é possível enviar todas as linhas dos resultados de um Look salvo. Essa opção ignora os limites definidos em um Look salvo ou no limite típico de 5 mil linhas do Looker. No entanto, existe um limite de dados de 15 MB para que os apps de e-mail aceitem o anexo. E-mails com mais de 15 MB e anexos não são enviados. Se você especificar um formato de tabela de dados ou visualização e selecionar Todos os resultados, o Looker vai mudar automaticamente o formato para usar um anexo de texto e enviar todos os resultados.

Para verificar se você está dentro do limite de linhas ou dados para e-mails programados, insira seu próprio endereço de e-mail como destinatário e clique em Enviar teste para enviar os dados para você mesmo imediatamente. Se você não receber o e-mail, provavelmente atingiu o limite de linhas ou de dados para e-mails.

Opções de e-mail

As entregas para e-mail têm outras opções de envio, que são Executar programação como destinatário e Incluir links.

Executar programação como destinatário

Essa opção está disponível apenas para o destino de e-mail.

A opção Executar programação como destinatário permite que os administradores especifiquem uma lista de usuários que vão receber o conteúdo como se tivessem executado a consulta, com base nas permissões deles. Os usuários que não são administradores também podem inserir o próprio endereço de e-mail para receber uma entrega como se tivessem consultado o conteúdo, com base nas permissões deles. Isso significa que os filtros de acesso e os atributos do usuário de cada usuário serão aplicados aos dados incluídos em cada e-mail.

Por exemplo, um administrador do Looker precisa programar uma consulta que conte os usuários agrupados por Estado para uma série de usuários, e cada usuário tem valores de filtro de acesso diferentes.

O usuário A tem um filtro de acesso definido como users.state = 'California'. Quando a opção Executar programação como destinatário é selecionada, a consulta programada aplica o filtro de acesso users.state = 'California' e envia os resultados filtrados para o usuário A. Os resultados vão mostrar uma linha apenas para a Califórnia.

Essa opção leva em conta as permissões do usuário que cria a programação, bem como os tipos de endereços de e-mail adicionados ao campo de texto Para quem enviar o e-mail?.

Em alguns casos, a opção Executar programação como destinatário não está disponível:

  1. Quando uma pessoa que não é administrador adiciona um endereço de e-mail que não é o próprio
  2. Quando um administrador do Looker adiciona o e-mail de um usuário desativado
  3. Quando um administrador do Looker adiciona um e-mail que não pertence a um usuário do Looker (uma conta do Looker é indicada por um ícone do Looker ao lado do destinatário)
  • Se o e-mail foi adicionado antes de selecionar a opção Executar agendamento como destinatário, ela será desativada automaticamente. Ele vai ficar disponível novamente se esse endereço de e-mail for excluído da lista de destinatários.
  • Se o endereço de e-mail foi adicionado após a opção Executar agenda como destinatário ter sido selecionada, o endereço de e-mail será removido automaticamente do campo Para quem enviar o e-mail? e um erro será gerado. A opção Executar programação como destinatário vai permanecer ativada.

No caso especial em que um usuário é listado como destinatário em uma programação com a opção Executar programação como destinatário ativada e a conta desse usuário é desativada, a programação não será entregue ao usuário desativado a partir da próxima execução. Se a conta desse usuário for excluída, toda a programação vai falhar na entrega para os destinatários. Um administrador ou usuário do Looker com a permissão see_schedules vai poder diagnosticar essa falha na página Histórico do agendador no painel Administrador.

Se o administrador do Looker tiver definido a política de dados enviados por e-mail da instância do Looker como Enviar links e dados, o Programador vai mostrar a opção Incluir links. Quando essa opção está marcada, os envios de dados por e-mail incluem um link de volta ao Looker com a mensagem "Ver relatório completo" para looks e análises enviados e "Ver painel completo" para painéis enviados.

Esse link permite que os destinatários do e-mail explorem os dados a fundo na instância do Looker. Os destinatários precisam fazer login no Looker e ter permissões para acessar o modelo em que o conteúdo entregue é baseado. Se você quiser remover esse link dos e-mails de entrega de dados, desmarque a caixa de seleção Incluir links.

Opções de formatação

As entregas que não usam o formato de visualização têm outras opções de envio, que são Aplicar opções de visualização e Valores de dados formatados.

Aplique opções de visualização

Essa opção não está disponível para envios de Análises ou Looks no formato de visualização.

  • Selecione Aplicar opções de visualização para que o envio de dados apareça semelhante a um gráfico de tabela. As seguintes configurações nos menus Gráfico, Série e Formatação que são configuradas para a visualização serão aplicadas:

    A formatação condicional aparece nos envios do Excel de Análises e Visualizações detalhadas com visualizações de gráficos de tabela somente se a regra Along a scale for aplicada.

  • Desmarque a opção Aplicar opções de visualização para que o Looker envie os dados conforme aparecem na seção Dados do Look ou na janela Explorar a partir daqui de um bloco do painel. JSON: rótulo usa o campo label, mesmo que a opção Aplicar opções de visualização não esteja selecionada.

Valores de dados formatados

Essa opção não está disponível para envios de Análises ou Looks no formato de visualização.

É possível configurar a formatação dos dados:

  • Selecione Valores de dados formatados se quiser que os dados apareçam de forma mais semelhante à experiência de Análise no Looker. No entanto, alguns recursos (como vinculação) não são compatíveis com todos os tipos de arquivo.
  • Desmarque Valores de dados formatados se você não quiser aplicar nenhuma formatação especial nos resultados da consulta, como arredondar números longos ou adicionar caracteres especiais que os desenvolvedores do Looker possam ter aplicado. Isso geralmente é preferível quando os dados são enviados para processamento em outra ferramenta.

Resolução da tabela

Ao enviar conteúdo para e-mail no formato de visualização, é possível personalizar a largura usando o menu suspenso Resolução da tabela. As opções de largura são:

  • Normal: 800 pixels
  • Grande: 1680 pixels

Se você escolher Amplo e a largura da visualização exceder o limite definido pelo cliente de e-mail, os destinatários da entrega de e-mail talvez precisem rolar horizontalmente para ver toda a visualização.

Fuso horário

Por padrão, o Looker usa o fuso horário associado à sua conta para determinar quando enviar a entrega de dados. Se você não tiver um fuso horário associado à sua conta, o Looker vai usar o fuso horário do aplicativo. Se você quiser especificar um fuso horário diferente, selecione Usar fuso horário personalizado. O fuso horário escolhido não afeta os dados do seu Look ou painel, apenas o tempo de exibição.

Como testar a entrega

Clique no botão Enviar teste para enviar um envio de teste único para o destino especificado.

Salvar a entrega

Um resumo das suas configurações de envio é exibido na parte de baixo do Programador.

Para envios únicos, quando terminar de configurar as opções de envio, clique no botão Enviar para enviar o conteúdo imediatamente para o destino especificado.

Para entregas recorrentes, quando terminar de configurar as opções de entrega, clique no botão Salvar tudo para salvar sua programação e fechar a janela. O conteúdo será entregue de acordo com suas configurações. Se você reabrir o Programador, a programação salva vai aparecer no painel esquerdo. Você pode duplicar ou excluir a programação clicando no ícone Duplicar ou Excluir, respectivamente.

A programação salva também vai aparecer na página Programações criadas no seu perfil de usuário e nas páginas Programações e Histórico de programação no painel Administrador. Consulte a seção Como conferir as entregas nesta página para mais informações.

Como conferir entregas

Você pode conferir as programações que criou e, com as permissões adequadas, todas as programações da instância do Looker.

Como conferir as entregas que você criou

Você pode conferir uma lista de todas as programações criadas na página Programações criadas. Para acessar essa página, clique no ícone do seu perfil de usuário e selecione Programações. Consulte a página Como visualizar suas entregas de dados programadas para mais informações sobre como visualizar e gerenciar as programações que você criou.

Como conferir entregas criadas por outros usuários

Se o administrador do Looker concedeu a você permissões para acessar as páginas de administrador Programações e Histórico de programação, você pode conferir a lista de todas as programações da instância do Looker. No entanto, não é possível editar ou excluir essas programações.

Informações úteis

Às vezes, a entrega de um e-mail programado pode falhar em um ou mais destinatários. Isso pode acontecer se o modelo tiver um erro, se o destinatário não tiver acesso aos dados ou se houver problemas de renderização ou erros de página.

Alguns outros desafios podem surgir:

  • Se a empresa configurou as próprias configurações de e-mail na seção Administrador do Looker, os administradores do Looker precisam verificar se as configurações estão corretas e se o provedor de e-mail está funcionando corretamente.
  • Dependendo da configuração Limite, a entrega de dados será limitada a 5.000 linhas ou a um tamanho máximo de arquivo de 15 MB para e-mails com anexos e 20 MB para e-mails com conteúdo inline. E-mails com mais linhas ou dados do que esses limites não serão enviados.
  • Se um e-mail não for enviado no horário esperado, mas chegar eventualmente, provavelmente é porque você está competindo com outras tarefas do Looker. Essas tarefas podem incluir outros e-mails programados, muitas pessoas analisando dados ao mesmo tempo ou tabelas derivadas persistentes sendo criadas. Se isso acontecer, consulte os administradores do Looker sobre tarefas concorrentes.
  • Se um e-mail específico continuar desaparecendo da sua lista de distribuição, é provável que um usuário esteja cancelando a inscrição nesse e-mail programado. Isso pode ser um desafio se você usar um alias de e-mail de grupo para enviar para várias pessoas, porque qualquer destinatário individual pode cancelar a inscrição nesse alias de e-mail. Se você precisar entender as desinscrições, confira esta postagem da Comunidade do Looker sobre como monitorar eventos de desinscrições do programador.