Exibição de Looks e Análises

Nesta página, você encontra uma visão geral do envio de Looks e Análises aos destinos de entrega integrados do Looker e aos serviços integrados disponíveis para sua instância do Looker. Para informações sobre como programar painéis, acesse a página de documentação Programação e envio de painéis.

O programador do Looker é o nome da janela pop-up em que você define as configurações do envio de conteúdo. Em Looks, é possível usar o Programador para enviar entregas únicas ou recorrentes. As Análises podem ser enviadas apenas uma vez. Se quiser programar o conteúdo da guia "Explorar" para uma entrega recorrente, salve o conteúdo como um Look.

Se você for 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 seu administrador do Looker.

Como abrir o Programador de uma pasta

Para as Análises, é possível abrir o Programador apenas dentro da Análise, não em uma pasta.

Para abrir o Programador em uma pasta ou subpasta, encontre a pasta ou subpasta que contém o dashboard que você quer entregar. Quando você navega até uma pasta, todos os Looks e dashboards dela são listados na visualização em lista ou na visualização 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 em lista, é possível abrir o Programador das seguintes formas:

  • Clicar no ícone do 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 Programar (para entregas recorrentes) ou Enviar (para entregas únicas)

Na visualização em grade, é possível abrir o Programador da seguinte forma:

  • Clicar no ícone do calendário de um item, se houver
  • Abra o conteúdo, clique no menu de engrenagem no canto superior direito e escolha Programar (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 escolha Programar (para entregas recorrentes) ou Enviar (para entregas únicas).

Para entregas recorrentes, o painel esquerdo do Programador legado mostra todas as programações criadas para o conteúdo e destaca o título da programação que você está criando ou editando. O painel esquerdo mostra as programações em ordem cronológica inversa, a partir da última atualização. É possível duplicar ou excluir programações clicando no ícone Duplicar ou Excluir à direita da programação, respectivamente.

Se esta for a primeira programação que você está criando para esse conteúdo, o painel principal exibirá opções de programação definidas com os valores padrão. É possível modificar esses valores conforme necessário. Se você já tiver criado uma ou mais programações para esse conteúdo, o painel principal exibirá as configurações salvas para a programação na parte superior da lista. Em seguida:

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

Quando terminar, clique em Salvar tudo.

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

Nomear a entrega

Dê um título exclusivo à programação no campo Dê um nome à programação. O título 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ções no painel Administrador.

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

  • Para entregas de e-mail, o título será usado na linha de assunto do e-mail e como parte do nome do arquivo se você selecionar um formato que use um anexo de e-mail.
  • Para webhooks, o título é incluído no payload do webhook no campo Título.
  • Nas entregas em um bucket do Amazon S3, o título é usado no nome do arquivo de entrega e nos 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 corresponderá ao fuso horário de exibição da programação.
  • Nas entregas em serviços integrados que geram um anexo de arquivo, o título é incluído no nome do arquivo da entrega.

  • Nos 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 corresponderá ao fuso horário de exibição da programação.

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

Como escolher o destino de entrega

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

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

Os destinos incluem:

Depois que você seleciona um destino de dados, um novo campo de configuração é exibido para adicionar detalhes específicos sobre esse destino, como um endereço de e-mail ou um URL do webhook.

Opções de entrega para e-mail

Escolha E-mail na seção Para onde esses dados devem ir?. Seu conteúdo será enviado a uma lista de endereços de e-mail especificados por você.

Na seção Para quem ela deve ser enviada por e-mail, digite 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 a você, talvez seja possível enviar e-mails para endereços não associados a qualquer 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 ter concedido permissões para enviar conteúdo a usuários externos ou ter adicionado os destinatários. domínios de e-mail para a permissão de domínios de e-mail para conteúdo programado.

Se o destinatário for outro usuário do Looker, essa pessoa terá a opção de vincular o painel ao painel pelo e-mail, a menos que o administrador do Looker tenha definido a política de dados por e-mail da instância do Looker como Enviar somente dados ou a opção Incluir links esteja desmarcada.

Se todos os destinatários cancelarem a inscrição em uma entrega programada de e-mail, essa programação será excluída do Looker, mesmo nas páginas de gerenciamento de programações 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 receberá entregas programadas de e-mail.

Consulte a seção Como aplicar opções avançadas de entrega nesta página para mais informações sobre entregas de e-mails.

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

Os envios 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 entrega para webhooks

Os webhooks são uma forma 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 entregues a uma ampla variedade de aplicativos. por exemplo, você pode programar a entrega periódica de um Look ou um dashboard para um webhook. Quando você configura uma entrega, o Looker solicita o endereço do webhook.

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

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

O procedimento exato varia de acordo com o serviço da Web e o aplicativo de destino usados para fornecer o painel. Confira esta postagem da Comunidade do Looker sobre Como programar Looks e dashboards usando webhooks (3.46+) para ver diretrizes sobre como configurar outro aplicativo para receber dados de webhook do Looker.

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

Opções de entrega para buckets do Amazon S3

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

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

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

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

Opções de envio para servidores SFTP

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

Observações sobre os envios SFTP:

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

Quando você escolhe usar o 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/

    Esse URL de exemplo termina com o caractere /. Isso indica que o arquivo será salvo em uma pasta chamada In. Se você não incluir o / final, o arquivo será salvo na pasta Marketing e "In" será anexado ao nome do arquivo. É preciso ter acesso de gravação na pasta em que você quer criar o arquivo.

  • Nome de usuário e Senha: credenciais de login do servidor SFTP

  • Algoritmo de troca de chaves preferencial: este 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 um algoritmo diferente. Alguns algoritmos levam muito tempo para gerar uma chave SSH. Essa opção permite usar um algoritmo que pode levar menos tempo. A escolha de um dos algoritmos o torna o algoritmo preferido para estabelecer a conexão SSH. Se o algoritmo não for suportado pelo servidor, todos os outros algoritmos serão usados nas tentativas subsequentes. Quando esse campo é definido como Padrão, é usada a ordem original dos algoritmos na biblioteca de conexão.

Atualmente, o suporte a SFTP está limitado a credenciais de nome de usuário e senha. As credenciais de chave privada SSH não são compatíveis.

Os algoritmos de chave de host aceitos pelos envios de SFTP do Looker são os seguintes:

  • 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 no envio do SFTP, isso pode indicar que as impressões digitais do SFTP são inválidas. Nesse caso, entre em contato com o administrador do Looker.

O erro Java::JavaLang::NullPointerExceptions ao enviar dados para um servidor SFTP pode ser causado por um bug no JRuby que impede o uso de algoritmos de curva elíptica (EC, na sigla em inglês) ou chaves de host para conexões SSH do Looker com destinos SFTP. Para evitar problemas com o envio de dados para destinos SFTP, não use algoritmos de EC nos arquivos ~/.ssh/config ou /etc/ssh_config nem armazene chaves de host de EC em ~/.ssh no seu 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 de arquivo:

<name>_<timestamp>_<token>.<file extension>
  • O nome informado no campo Dê um nome à sua programação depois que o Looker remover todos os caracteres diferentes de 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
  • Token composto de uma string aleatória de seis caracteres
  • A extensão do arquivo

Por exemplo: Test_Schedule_2019-04-11T1130_HWkvys.csv

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

É possível programar ou enviar um Look ou os resultados de uma Análise 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 específicas 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 Looker Action Hub em que você pode mostrar um Look ou os resultados de uma Análise.

Veja como usar a lista:

  • Os URLs na coluna Link para o arquivo README têm instruções sobre como ativar e configurar o serviço integrado para funcionar com o Looker.
  • Os URLs mostrados na coluna Como usar essa integração dão instruções de como enviar dados do Looker para o serviço integrado. Alguns desses artigos também contêm instruções de ativação.
  • Tags do LookML obrigatórias lista todas as tags que precisam ser usadas com o parâmetro tags no modelo subjacente do conteúdo.
  • O tipo de ação indica o nível de dados que o serviço integrado está enviando: campo, consulta ou painel. Uma ação em nível de 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 ou um Look. Uma ação no nível do painel envia a imagem de um painel.
  • Usa a autenticação OAuth do Google indica se o serviço integrado usa as credenciais do Google OAuth para autenticação.
  • Usa o streaming de dados indica se o serviço integrado oferece suporte aos resultados da consulta com 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 fluxo de dados (Sim/Não)
Airtable Adicione registros a uma tabela no Airtable. Ver o README no GitHub Confira o artigo da comunidade Nenhum Consulta Não Não
Inferência do SageMaker da Amazon Realizar uma inferência usando o Amazon SageMaker. Nenhum README disponível Nenhum artigo disponível Nenhum Consulta Não Sim
Amazon SageMaker Train: aprendizado linear Iniciar um job de treinamento no Amazon SageMaker usando o algoritmo de aprendizado linear. Nenhum README disponível Nenhum artigo disponível Nenhum Consulta Não Sim
Trem do SageMaker da Amazon: Xgboost Iniciar um job de treinamento no SageMaker da Amazon usando o algoritmo Xgboost. Nenhum README disponível Nenhum artigo disponível Nenhum Consulta Não Sim
Instância de parada do Amazon Web Services EC2 Interrompa uma instância do EC2 usando a API Amazon EC2. Ver o README no GitHub Confira o artigo da comunidade aws_resource_id Campo, consulta Não Não
Trado Usa o resultado da consulta para criar um modelo preditivo. Ver o README no GitHub Consulte o arquivo README Nenhum Consulta Não Sim
Armazenamento do Azure Envie e armazene um arquivo de dados no Armazenamento do Azure. Ver o README no GitHub Confira o artigo da comunidade Nenhum Consulta Não Sim
Braze A ação Braze permite sinalizar usuários no Braze usando o endpoint da API REST de um Look. Verifique se há um campo braze_id marcado nos resultados. EXPORTAÇÃO MÁXIMA: 10.000. Ver o README no GitHub Consulte o arquivo README braze_id Consulta Não Sim
DataRobot Enviar dados para o DataRobot e criar um novo projeto. Ver o README no GitHub Consulte o arquivo README Nenhum Consulta Não Sim
DigitalOcean — gota de parada Interrompa o processo da DigitalOcean usando a API DigitalOcean. Ver o README no GitHub Confira o artigo da comunidade digitalocean_droplet_id Campo, consulta Não Não
Espaços da DigitalOcean Envie e armazene um arquivo de dados no armazenamento da DigitalOcean. Ver o README no GitHub Confira o artigo da comunidade Nenhum Consulta Não Sim
Dropbox Envie e armazene 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 Fazer upload dos dados da lista de clientes para os públicos-alvo personalizados de anúncios do Facebook. Ver o README no GitHub Consulte o arquivo 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
Segmentação por lista de clientes do Google Ads Fazer o upload dos dados para a Segmentação por lista de clientes do Google Ads. Ver o README no GitHub Consulte a documentação Nenhum Consulta Sim Sim
Importação de dados do Google Analytics Fazer upload de dados para um conjunto de dados do Google Analytics. Ver o README no GitHub Consulte o arquivo README Nenhum Consulta Sim Sim
Google Cloud Storage Gravar arquivos de dados em um bucket do Google Cloud Storage. Ver o README no GitHub Confira 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 Envie dados CSV para uma planilha Google. Nenhum README disponível Consulte a documentação Nenhum Consulta Sim Sim
Empresas Hubspot Adicione propriedades às suas empresas usando a API Hubspot V3. Ver o README no GitHub Consulte o arquivo README hubspot_company_id Consulta Não Sim
Contatos do Hubspot Adicione propriedades aos seus contatos usando a API Hubspot V3. Ver o README no GitHub Consulte o arquivo README hubspot_contact_id Consulta Não Sim
Kloudio Adicione dados a uma planilha Google. Ver o README no GitHub Consulte o arquivo README Nenhum Consulta Não Não
mParticle Exporte em massa os dados de usuários ou eventos do Looker para o mParticle. Ver o README no GitHub Consulte o arquivo README Consulte o arquivo README Consulta Não Sim
Campanhas do Salesforce Adiciona contatos ou leads à campanha do Salesforce. Ver o README no GitHub Consulte o arquivo README sfdc_contact_id ou sfdc_lead_id Consulta Sim Não
Grupo de segmento Adicione características e/ou usuários aos grupos de segmentos. Ver 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
Identificação do segmento Adicione características ao segmento de usuários usando o recurso "Identificar". Ver o README no GitHub Consulte a documentação email, user_id, segment_anonymous_id ou segment_group_id Consulta Não Sim
Segmento de acompanhamento Conecte-se a várias integrações fornecidas pelo Segment para identificar e segmentar usuários para fluxos de trabalho de marketing. Ver o README no GitHub Consulte a documentação email, user_id, segment_anonymous_id ou segment_group_id Consulta Não Sim
SendGrid Enviar dados e programar resultados para enviar a um endereço de e-mail usando a API do SendGrid. Ver o README no GitHub Confira o artigo da comunidade Nenhum Consulta Não Não
Slack Envie conteúdo do Looker em mensagens diretas, canais públicos e canais 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
Anexo do Slack (token de API) Envie dados diretamente para um canal do Slack com as credenciais do usuário. Consulte a documentação do Lookerbot (em inglês) para acessar outras funcionalidades do Slack. Ver o README no GitHub Consulte a documentação Nenhum Consulta Não Não
Equipes: webhook de entrada Enviar dados para o Microsoft Teams usando um webhook de entrada. Ver o README no GitHub Consulte o arquivo README Nenhum Consulta Não Não
Bandeja Conecte-se a várias integrações fornecidas pela Tray.io para automatizar os fluxos de trabalho. Ver o README no GitHub Confira o artigo da comunidade Nenhum Consulta Não Sim
Twilio — enviar dados Envie dados de um Look ou programe o envio de resultados para um número de telefone usando a API do Twilio. Ver o README no GitHub Confira 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 um Look. Ver o README no GitHub Consulte o arquivo README telefone Campo, consulta Não Não
Zapier Conecte-se a várias integrações disponibilizadas pelo Zapier para automatizar os fluxos de trabalho. Ver o README no GitHub Confira o artigo da comunidade Nenhum Consulta Não Sim

Escolher o formato de dados

Para as entregas 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 instância do Looker como Enviar apenas o link.

As Análises e as Análises apresentam diferentes opções de formatação, dependendo do destino da entrega. Para escolher o formato da entrega, selecione o ícone adequado na seção Formatar dados como do Programador.

Consulte a tabela a seguir para uma explicação de como cada formato é entregue a 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 do campo de uma dimensão ou medida como 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 do campo de uma dimensão ou medida como 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 do campo de uma dimensão ou medida como 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 do campo de uma dimensão ou medida como 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 do campo de uma dimensão ou medida como 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 mais detalhes, como metadados de campo, informações de cache, o tempo em que a consulta foi concluída e quanto tempo ela levou para ser executada. Nesse formato, o Looker usa o nome do campo de uma dimensão ou medida como valor renderizado em vez do rótulo do campo. A tabela de dados enviada diretamente no formato JSON, com mais detalhes, como metadados de campo, informações de cache, o tempo em que a consulta foi concluída e quanto tempo ela levou para ser executada. Nesse formato, o Looker usa o nome do campo de uma dimensão ou medida como valor renderizado em vez do rótulo do campo. A tabela de dados enviada diretamente no formato JSON, com mais detalhes, como metadados de campo, informações de cache, o tempo em que a consulta foi concluída e quanto tempo ela levou para ser executada. Nesse formato, o Looker usa o nome do campo de uma dimensão ou medida como valor renderizado em vez do rótulo do campo.
Texto A tabela de dados como um anexo de arquivo de texto delimitado por tabulações A tabela de dados como um anexo de arquivo de texto delimitado por tabulações A tabela de dados como um anexo de arquivo de texto delimitado por tabulações A tabela de dados como um anexo de arquivo de texto delimitado por tabulações
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

Acionando a entrega

Você não terá essa opção ao enviar um Explore ou uma entrega única de um Look.

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

  • Intervalo de repetição: selecione esta opção para usar a programação de entrega definida na seção Especificar a recorrência da entrega nesta página.
  • Atualização do grupo de dados: se o desenvolvedor do LookML tiver configurado grupos de dados, será possível programar a entrega para ocorrer depois que um grupo for acionado, gerenciar o cache e recriar PDTs relevantes.

Como especificar o gatilho do grupo de dados

Você não verá essa opção ao enviar um Explore, uma entrega única de um Look ou se tiver especificado um acionador de intervalo de repetição para sua entrega recorrente.

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

Para programar conteúdo usando um gatilho de grupo de dados, o arquivo de modelo em que o conteúdo se baseia 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 dashboard fornecido, mesmo que os grupos de dados não sejam usados para processar o armazenamento em cache para consultas ou PDTs.

As programações com base em grupos de dados só são acionadas para entrega após a conclusão do processo de regeneração para todas as PDTs mantidas com esse grupo de dados, garantindo que sua entrega inclua os dados mais atualizados.

Como especificar a recorrência da entrega

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

Para entregas que usam um intervalo de repetição, é possível personalizar o horário da programação na seção Entregar esta programação. Selecione Intervalo de repetição na seção Gatilho do Programador. As opções mudam de acordo com sua escolha: Diariamente, Semanalmente, Mensalmente, Por hora ou Por minuto. Você pode ajustar o fuso horário da programação na seção Opções avançadas.

O horário de término para intervalos Por hora e Por minuto não é inclusivo. 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 0h e 23h, ele será enviado nessa hora, a cada hora, das 0h às 22h. Se o conteúdo for programado Por minuto a cada 30 minutos entre 0h e 23h, a última entrega nesse período será enviada às 22h30.

Aplicar filtros à entrega

Você não vai ter essa opção ao enviar uma Análise.

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

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

Se você mudar os nomes dos campos que servem como filtros nos Looks ou dashboards, consulte a seção Filtros dos Looks e dashboards programados e atualize os filtros conforme necessário para refletir as mudanças. Se um envio de conteúdo programado incluir filtros que não funcionam mais (por exemplo, se o campo referenciado tiver sido alterado), o envio programado poderá expor dados não filtrados.

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

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 expandir o menu. As opções disponíveis dependem do destino e formato selecionados da sua entrega e da exibição de um dashboard, Look ou uma Análise. Os links na tabela abaixo direcionam para uma descrição de cada opção disponível para envios de Looks ou Análises aos destinos integrados do Looker. Os envios para integrações de terceiros podem ter opções avançadas exclusivas disponíveis.

Formato E-mail Webhook Amazon S3 SFTP
Tabela de dados
Envie esta programação se Indisponível para este destino Indisponível para este destino Indisponível para este destino
Limite
Opções de e-mail Executar uma 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 Indisponível para este destino Indisponível para este destino Indisponível para este destino
Opções de e-mail Executar uma programação como destinatário
Incluir links
Resolução da tabela
Fuso horário
CSV
Envie esta programação se Envie esta programação se Envie esta programação se Envie esta programação se
Limite Limite Limite Limite
Opções de e-mail Executar uma programação como destinatário Indisponível para este destino Indisponível para este destino Indisponí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
Envie esta programação se Envie esta programação se Envie esta programação se Envie esta programação se
Limite Limite Limite Limite
Opções de e-mail Executar uma programação como destinatário Indisponível para este destino Indisponível para este destino Indisponí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
Envie esta programação se Envie esta programação se Envie esta programação se Envie esta programação se
Limite Limite Limite Limite
Opções de e-mail Executar uma programação como destinatário Indisponível para este destino Indisponível para este destino Indisponí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 Indisponível para este destino Limite Limite Limite
Indisponível para este destino Fuso horário Fuso horário Fuso horário
Texto
Envie esta programação se Envie esta programação se Envie esta programação se Envie esta programação se
Limite Limite Limite Limite
Opções de e-mail Executar uma programação como destinatário Indisponível para este destino Indisponível para este destino Indisponí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
Envie esta programação se Envie esta programação se Envie esta programação se Envie esta programação se
Limite Limite Limite Limite
Opções de e-mail Executar uma programação como destinatário Indisponível para este destino Indisponível para este destino Indisponí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 apenas quando determinadas condições forem atendidas. Os alertas oferecem uma função semelhante para blocos do dashboard.

No menu suspenso Enviar esta programação se, especifique se você quer entregar o conteúdo do Look apenas se houver resultados, somente se não houver resultados ou se não houver 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 de inventário, despesas que estão acima de um determinado valor e assim por diante, e entregar o conteúdo somente se essa condição tiver sido atingida.

Também é possível especificar que uma entrega só será feita se os resultados da consulta tiverem sido alterados desde o último envio de dados. Para isso, marque a caixa ao lado de e os resultados foram alterados desde a última execução. Essa opção não estará disponível se você quiser usar a opção de limite Todos os resultados.

Limite

Você pode limitar o tamanho da sua entrega selecionando uma das seguintes opções de limite para seus dados:

  • Resultados na tabela: os dados são enviados como uma única entrega.
  • Todos os resultados:os dados são transmitidos. Saiba mais em Quais são os limites de linhas no Looker? práticas recomendadas). Isso é útil para grandes conjuntos de dados, pois 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 configuradas no Look salvo ou na Análise. Se você escolher Todos os resultados, o Looker vai retornar todas as linhas da consulta, independente das configurações salvas do Look e do limite típico de 5.000 linhas do Looker. Isso pode ser útil para recuperar conjuntos de dados muito grandes, mas tenha 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 Explores, é possível limitar o tamanho do e-mail para não ultrapassar as limitações 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, poderá enviar todas as linhas de resultados de um Look salvo. Essa opção ignora os limites definidos em um Look salvo ou no limite típico de 5.000 linhas do Looker. Entretanto, existe um limite total de dados de 15 MB para que os aplicativos de e-mail aceitem o anexo. E-mails com mais de 15 MB com anexos não serã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 aceitar o envio de todos os resultados.

Para verificar se você está dentro do limite de linhas ou dados para e-mails programados, digite seu endereço de e-mail como destinatário e clique em Enviar teste para enviar os dados para si mesmo imediatamente. Se você não receber o e-mail, é provável que tenha atingido o limite de linhas ou de dados para e-mails.

Opções de e-mail

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

Executar programação como destinatário

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

A opção Executar programação como destinatário permite que os administradores especifiquem uma lista de usuários que receberão o envio de conteúdo como se tivessem executado a consulta, com base nas permissões. 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. Isso significa que os filtros de acesso e os atributos de cada usuário serão aplicados aos dados incluídos em cada e-mail.

Por exemplo, um administrador do Looker precisa programar um relatório que conte os Usuários agrupados por Estado em uma série de usuários, cada um com diferentes valores de filtro de acesso.

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 exibirão uma linha somente para a Califórnia.

Essa opção considera as permissões do usuário que está criando a programação, bem como os tipos de endereços de e-mail adicionados ao campo de texto Para quem ela deve ser enviada por e-mail?.

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

  1. Quando um usuário que não é administrador adiciona um endereço de e-mail que não é o seu
  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 tiver sido adicionado antes de a opção Executar programação como destinatário ser selecionada, ela será desativada automaticamente. Ele 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 tiver sido adicionado após a opção Executar programação como destinatário ter sido selecionada, ao adicionar o endereço de e-mail, ocorrerá um erro, e o e-mail será removido automaticamente do campo Para quem ele deve ser enviado por e-mail?. A opção Executar programação como destinatário vai continuar ativada.

No caso especial em que um usuário está listado como destinatário em uma programação com a opção Executar programação como destinatário ativada e, em seguida, a conta desse usuário é desativada, a programação não será entregue a ele na próxima vez que for executada. Se a conta desse usuário for excluída, toda a programação não será entregue para os destinatários. Um administrador ou usuário do Looker com a permissão see_schedules poderá diagnosticar essa falha na página Histórico do programador 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 uma opção para Incluir links. Quando essa opção está marcada, os envios de dados por e-mail incluem um link de retorno para o Looker com a mensagem "Acessar relatório completo". para os Looks e Explores entregues e a opção "Ver dashboard completo" para os painéis entregues.

Esse link permite que os destinatários do e-mail analisem melhor os dados na sua 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 enviado se baseia. Caso queira remover essa vinculação dos e-mails de entrega de dados, desmarque a caixa de seleção Incluir links.

Opções de formatação

Os envios que não usam o formato de visualização têm outras opções de exibição, 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 do Look ou da Análise no formato de visualização.

Valores de dados formatados

Essa opção não está disponível para envios do Look ou da Análise no formato de visualização.

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

  • Selecione Valores de dados formatados se quiser que os dados sejam parecidos com a experiência Explorar no Looker, embora alguns recursos (como a vinculação) não sejam compatíveis com todos os tipos de arquivo.
  • Desmarque Valores de dados formatados se não quiser aplicar nenhuma formatação especial aos resultados da consulta, como arredondar números longos ou adicionar caracteres especiais que os desenvolvedores do Looker possam ter usado. Isso geralmente é preferível quando os dados são enviados para processamento em outra ferramenta.

Resolução da tabela

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

  • Normal: 800 pixels
  • Grande: 1680 pixels

Se você escolher Ampla, 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 a tela horizontalmente para exibir a visualização inteira.

Fuso horário

Por padrão, o Looker usa o fuso horário associado à sua conta para determinar quando enviar os dados. Se você não tiver um fuso horário associado à sua conta, o Looker 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 selecionado não afeta os dados no Look ou no dashboard, apenas o horário da exibição.

Como testar a entrega

Clique no botão Send Test para enviar um teste único de entrega ao destino especificado.

Salvando a entrega

Um resumo das configurações de entrega é exibido na parte inferior do Programador.

Em entregas únicas, quando você terminar de configurar as opções de entrega, clique no botão Enviar para enviar o conteúdo imediatamente ao destino especificado.

Para entregas recorrentes, quando você tiver terminado 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á enviado de acordo com suas configurações de envio. Se você reabrir o Programador, a programação salva vai aparecer no painel esquerdo. É possível duplicar ou excluir a programação clicando no ícone Duplicar ou Excluir, respectivamente.

A programação salva também será exibida na página Programações que você criou no perfil de usuário e nas páginas Programações e Histórico de programações no painel Administrador. Consulte a seção Como visualizar entregas nesta página para mais informações.

Como visualizar envios

É possível conferir as programações que você criou e, com as permissões apropriadas, todas as programações da instância do Looker.

Exibição de entregas que você criou

Acesse a página Programações que você criou para ver uma lista de todas as programações. Para acessá-la, clique no ícone do 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.

Exibição de entregas criadas por outros usuários

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

Informações úteis

Às vezes, um e-mail programado pode não chegar a um ou mais dos destinatários. Isso pode acontecer se o modelo subjacente 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.

Outros desafios podem surgir:

  • Caso sua empresa tenha definido as próprias configurações de e-mail na seção Administrador do Looker, os administradores do Looker vão precisar confirmar 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 que esses limites não serão enviados.
  • Se um e-mail não é enviado no momento esperado, mas chega, é provável que você esteja competindo com outras tarefas do Looker. Essas tarefas podem incluir outros e-mails programados, muitas pessoas explorando dados ao mesmo tempo ou a criação de tabelas derivadas persistentes. Se isso acontecer, converse com 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 tenha cancelado a inscrição no e-mail programado. Esse pode ser um desafio específico se você usar um alias de e-mail de grupo para enviar mensagens a várias pessoas, porque qualquer destinatário pode cancelar a inscrição do alias de e-mail inteiro. Se você precisar entender o cancelamento de assinaturas, confira esta postagem da Comunidade do Looker sobre o monitoramento de eventos de cancelamento de inscrição do programador.