Como enviar Looks e Explores

Nesta página, você encontra uma visão geral da entrega de Looks e Explores para os destinos de entrega nativos do Looker e para todos os serviços integrados disponíveis para sua instância do Looker. Para mais informações sobre a programação de 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 de envio de conteúdo. No caso dos Looks, é possível usar o Scheduler para enviar entregas únicas ou recorrentes. Os Explores só podem ser enviados como entregas únicas. Para programar o conteúdo do Explorar para envio recorrente, primeiro salve 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 envio disponíveis dependem das permissões relacionadas à entrega concedidas a você pelo administrador do Looker.

Como abrir o Programador em uma pasta

Para o recurso "Explores", só é possível abrir o Programador dentro de Explore, 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ê navega até uma pasta, todos os Looks e dashboards dentro 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, é preciso passar 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:

  • Clicar no ícone da agenda de um item (se houver)
  • Clique no menu de três pontos de um item e escolha 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 das seguintes formas:

  • Clicar no ícone da agenda 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).

O Looker mostra o Programador legado.

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 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ê 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 como quiser. 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. Depois, siga estas instruções:

  • Para editar as opções de uma programação, selecione-a e altere as opções como quiser. Quando terminar, clique em Salvar tudo.
  • Para criar programações adicionais para o mesmo conteúdo, clique em Novo + e insira as configurações para essa programação adicional.

Quando terminar, clique em Salvar tudo.

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

Nomear a entrega

Dê um título exclusivo à programação no campo Dê um nome à programação. O título será exibido no painel esquerdo 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-mails, o título é 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 Title.
  • Para entregas a um bucket do Amazon S3, o título é usado no nome do arquivo da entrega e nos e-mails de erro enviados. O nome do arquivo do envio 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 entrega da programação.
  • Para entregas em serviços integrados que geram um anexo, o título é incluído no nome do arquivo do envio.

  • Para envios SFTP, o título é incluído no nome do arquivo do envio. O nome do arquivo do envio 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 entrega da programação.

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

Escolher o destino de entrega

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

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

Os destinos incluem:

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

Opções de entrega de e-mail

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

Na seção Para quem deve ser enviado por e-mail, digite os endereços de e-mail dos destinatários. Digite 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, é possível enviar e-mails para endereços que não estã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 a você permissões para enviar conteúdo a usuários externos ou adicionado os domínios de e-mail desses destinatários à permissão de domínio de e-mail para conteúdo programado.

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

Se todos os destinatários cancelarem a inscrição em uma entrega programada de e-mails, essa programação será excluída do Looker, mesmo das 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á as entregas programadas.

Consulte a seção Como aplicar opções avançadas de entrega nesta página para mais informações sobre as 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 de 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 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 entregues a uma ampla variedade de aplicativos. Por exemplo, é possível programar a entrega periódica de um Look ou 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 em que o Looker vai enviar uma solicitação HTTPS para essa entrega. Você pode acessar 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. Encontre um URL para onde 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 difere dependendo do serviço da Web e do aplicativo de destino que você está usando para entregar o painel. Confira esta postagem da Comunidade do Looker sobre Programar Looks e painéis usando webhooks (mais de 3,46) para conferir as diretrizes sobre como configurar outro aplicativo para receber dados de webhook do Looker.

O Looker vai tentar enviar 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 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 solicitará mais configurações sobre a formatação e o bucket do Amazon S3, conforme descrito nesta página. Veja esta postagem da comunidade do Looker sobre Programação (ilimitada) de resultados para S3 (em inglês) para 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 é exibida 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 seu bucket do S3, fornecido pela Amazon.
  • Chave secreta: a chave de acesso secreta ao bucket do S3, fornecida pela Amazon.
  • Região: a região de serviços da Amazon em que seu bucket do S3 está hospedado.

Opções de entrega para servidores SFTP

Escolha SFTP na seção Para onde esses dados devem ir? 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 muito grandes para serem enviados por e-mail. Quando você escolhe essa opção de entrega, o Looker solicita o endereço do servidor SFTP, o nome de usuário e a senha conforme descrito abaixo.

Observações sobre as entregas de SFTP:

  • Para receber envios de SFTP do Looker, o administrador da rede precisa adicionar 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 do arquivo de envio. O Looker vai remover todos os caracteres diferentes de A-Z, a-z, 0-9, _ ou - do que você inserir no campo Dê um nome à 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 seus 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 / à direita, o arquivo será salvo na pasta Marketing, e "In" será adicionado ao início do nome do arquivo. É necessário ter acesso de gravação à pasta em que o arquivo será criado.

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

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

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

Os principais algoritmos de host com suporte nas entregas de 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 do SFTP para o servidor SFTP. Se você encontrar erros no envio do SFTP, isso pode indicar que as impressões digitais são inválidas. Nesse caso, entre em contato com seu administrador do Looker.

Se você receber o erro Java::JavaLang::NullPointerExceptions ao enviar dados para um servidor SFTP, talvez seja devido a um bug no JRuby que impede o uso de algoritmos de curva elíptica (EC) e/ou chaves de host para conexões SSH do Looker a destinos SFTP. Se quiser evitar problemas no 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 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 que você informou no campo Forneça um nome à programação depois que o Looker remover 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
  • Token composto por 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 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 Destination 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 enviar um Look ou os resultados de uma Análise.

Veja como usar a lista:

  • Os URLs na coluna Link para o arquivo README fornecem instruções para ativar e configurar o serviço integrado para funcionar com o Looker.
  • Os URLs na coluna Como usar essa integração fornecem instruções sobre como enviar dados do Looker ao serviço integrado. Alguns artigos também contêm instruções de ativação.
  • Tags do LookML obrigatórias lista aquelas que precisam ser usadas com o parâmetro tags no modelo de base 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 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 um Explore ou Look. Uma ação no nível do painel envia uma imagem de um painel.
  • Usa a autenticação do Google OAuth indica se o serviço integrado usa as credenciais do Google OAuth para autenticação.
  • Usa streaming de dados indica se o serviço integrado é compatível com resultados de consulta transmitidos.
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 do Google OAuth (Sim/Não) Usa streaming de dados (Sim/Não)
Ar Adicione registros a uma tabela no Airtable. Consulte o README no GitHub Confira o artigo da comunidade Nenhuma Consulta No No
Inferência do Amazon SageMaker Faça uma inferência usando o Amazon SageMaker. Nenhum README disponível Nenhum artigo disponível Nenhuma Consulta No Sim
Amazon SageMaker Train: aprendizagem linear Inicie um job de treinamento no Amazon SageMaker usando o algoritmo de aprendizado linear. Nenhum README disponível Nenhum artigo disponível Nenhuma Consulta No 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 Nenhuma Consulta No Sim
Interromper instância do Amazon Web Services EC2 Interrompa uma instância do EC2 usando a API Amazon EC2. Consulte o README no GitHub Confira o artigo da comunidade aws_resource_id Campo, consulta No No
Trado Usa o resultado da consulta para criar um modelo preditivo. Consulte o README no GitHub Consulte o README Nenhuma Consulta No Sim
Armazenamento do Azure Envie e armazene um arquivo de dados no Armazenamento do Azure. Consulte o README no GitHub Confira o artigo da comunidade Nenhuma Consulta No 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. Consulte o README no GitHub Consulte o README braze_id Consulta No Sim
DataRobot Enviar dados para o DataRobot e criar um novo projeto. Consulte o README no GitHub Consulte o README Nenhuma Consulta No Sim
DigitalOcean — Stop Droplet Interromper o processo da DigitalOcean usando a API DigitalOcean. Consulte o README no GitHub Confira o artigo da comunidade digitalocean_droplet_id Campo, consulta No No
Espaços da DigitalOcean Envia e armazena um arquivo de dados no DigitalOcean Storage. Consulte o README no GitHub Confira o artigo da comunidade Nenhuma Consulta No Sim
Dropbox Enviar e armazenar um arquivo de dados no Dropbox. Nenhum README disponível Consulte a documentação Nenhuma Consulta Sim No
Públicos-alvo personalizados do Facebook Faça upload dos dados da lista de clientes para os públicos-alvo personalizados dos anúncios do Facebook. Consulte o README no GitHub Consulte o README Nenhuma Consulta Sim Sim
Firebase Use o Firebase para enviar notificações push para dispositivos móveis. Nenhum README disponível Nenhum artigo disponível Nenhuma Consulta No No
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. Consulte o README no GitHub Consulte a documentação Nenhuma Consulta Sim Sim
Importação de dados do Google Analytics Faça upload dos dados para um conjunto de dados do Google Analytics. Consulte o README no GitHub Consulte o README Nenhuma Consulta Sim Sim
Google Cloud Storage Gravar arquivos de dados em um bucket do Google Cloud Storage. Consulte o README no GitHub Confira o artigo da comunidade Nenhuma Consulta No Sim
Google Drive Enviar dados para o Google Drive. Nenhum README disponível Consulte a documentação Nenhuma Consulta Sim Sim
Planilhas Google Enviar dados CSV para um arquivo das Planilhas Google. Nenhum README disponível Consulte a documentação Nenhuma Consulta Sim Sim
Empresas Hubspot Adicione propriedades às suas empresas usando a API Hubspot V3. Consulte o README no GitHub Consulte o README hubspot_company_id Consulta No Sim
Contatos do Hubspot Adicione propriedades aos seus contatos usando a API Hubspot V3. Consulte o README no GitHub Consulte o README hubspot_contact_id Consulta No Sim
Kloudio Adicionar dados a um arquivo das Planilhas Google. Consulte o README no GitHub Consulte o README Nenhuma Consulta No No
mParticle Exporte em massa os dados de usuários ou eventos do Looker para o mParticle. Consulte o README no GitHub Consulte o README Consulte o README Consulta No Sim
Campanhas do Salesforce Adiciona contatos ou leads à campanha do Salesforce. Consulte o README no GitHub Consulte o README sfdc_contact_id ou sfdc_lead_id Consulta Sim No
Grupo de segmento Adicione características e/ou usuários aos seus grupos de segmentos. Consulte o README no GitHub Consulte a documentação segmento_group_id e user_id ou segment_group_id e segment_anonymous_id Consulta No Sim
Identificação de segmentos Adicione características aos seus usuários do segmento usando a ferramenta Identificar. Consulte o README no GitHub Consulte a documentação email, user_id, segment_anonymous_id ou segment_group_id Consulta No Sim
Faixa de segmentos Conecte-se a uma série de integrações fornecidas pelo Segment para identificar e segmentar usuários para fluxos de trabalho de marketing. Consulte o README no GitHub Consulte a documentação email, user_id, segment_anonymous_id ou segment_group_id Consulta No Sim
SendGrid Envie dados e programe resultados para enviá-los a um endereço de e-mail usando a API do SendGrid. Consulte o README no GitHub Confira o artigo da comunidade Nenhuma Consulta No No
Slack Envie conteúdo do Looker em mensagens diretas, canais públicos e canais privados 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 Nenhuma Consulta Sim Sim
Anexo 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 ver outras funcionalidades do Slack. Consulte o README no GitHub Consulte a documentação Nenhuma Consulta No No
Equipes: webhook de entrada Enviar dados para o Microsoft Teams usando um webhook de entrada. Consulte o README no GitHub Consulte o README Nenhuma Consulta No No
Bandeja Conecte-se a diversas integrações fornecidas pela Tray.io para automatizar fluxos de trabalho. Consulte o README no GitHub Confira o artigo da comunidade Nenhuma Consulta No Sim
Twilio: enviar dados Envie dados de um Look ou programe resultados para enviar a um número de telefone usando a API do Twilio. Consulte o README no GitHub Confira o artigo da comunidade Nenhuma Consulta No No
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. Consulte o README no GitHub Consulte o README telefone Campo, consulta No No
Zapier Conecte-se a diversas integrações fornecidas pelo Zapier para automatizar fluxos de trabalho. Consulte o README no GitHub Confira o artigo da comunidade Nenhuma Consulta No Sim

Escolher o formato de dados

Nas 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 enviados por e-mail da instância do Looker como Enviar somente link.

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

Consulte a tabela abaixo para saber como cada formato é enviado 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 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 do campo de uma dimensão ou medida 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 do campo de uma dimensão ou medida 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 do campo de uma dimensão ou medida 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 labels 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 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, a hora 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 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, a hora 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 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, a hora 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 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çõ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

Acionamento da entrega

Essa opção não será exibida se você estiver enviando um Explore ou um envio único de um Look.

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

  • Intervalo de repetição: selecione essa opção para usar a programação de entrega definida na seção Especificar a recorrência de entrega desta página.
  • Atualização do datagroup: se o desenvolvedor do LookML tiver configurado datagroups, será possível programar a entrega para ocorrer após o acionamento de um grupo de dados, o gerenciamento do cache e a recriação das TDPs relevantes.

Como especificar o gatilho do datagroup

Essa opção não será exibida se você enviar uma Análise, uma entrega única de um Look ou se tiver especificado um acionador de intervalo de repetição para seu envio recorrente.

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

Para programar conteúdo usando um acionador de datagroup, o arquivo de modelo em que o conteúdo se baseia precisa incluir um datagroup. O Looker lista todos os grupos de dados definidos nos modelos incluídos no bloco do Look ou dashboard especificado, mesmo que os grupos de dados não sejam usados para processar o armazenamento em cache de consultas ou TDPs.

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

Especificar a recorrência de entrega

Essa opção não será exibida se você estiver enviando uma Análise, uma entrega única de um Look ou se tiver especificado um acionador de atualização de grupo de dados para seu envio recorrente.

Para as entregas que usam um intervalo de repetição, é possível personalizar o tempo da sua programação na seção Enviar esta programação. Selecione Intervalo de repetição na seção Acionador do Programador. As opções mudam conforme você escolhe: Diariamente, Semanalmente, Mensalmente, A cada hora ou Por minuto. Ajuste 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 inclui esses dados. A última exibição será enviada no último intervalo selecionado, antes do horário de término especificado. Por exemplo, se o conteúdo estiver programado Por hora entre 0h e 23h, ele será enviado em hora, a cada hora, das 0h às 22h. Se o conteúdo estiver programado Por minuto a cada 30 minutos entre 12h00 e 13h0.

Aplicando filtros à entrega

Essa opção não será exibida se você estiver enviando um Explore.

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

Clique em Filtros para conferir e modificar os filtros associados a esse Look ou dashboard para sua exibição. Mudar essas opções de filtro no Programador não muda os filtros no Look ou no dashboard. Se um filtro do 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 entrega.

Se você mudar nomes de campos que servem como filtros nos Looks ou dashboards, revise 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 mudado), ela 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 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 de cada usuário, o que significa que você pode enviar resultados personalizados para vários usuários, mesmo que envie uma entrega única. Para saber mais, consulte a página de documentação Atributos do usuário.

Como aplicar opções de entrega avançadas

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 esse menu. As opções disponíveis dependem do destino e formato selecionados para o envio e se você está enviando um dashboard, um 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 Explores aos destinos nativos 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 esse destino Indisponível para esse destino Indisponível para esse 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 Indisponível para esse destino Indisponível para esse destino Indisponível para esse destino
Opções de e-mail Executar 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 programação como destinatário Indisponível para esse destino Indisponível para esse destino Indisponível para esse 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 programação como destinatário Indisponível para esse destino Indisponível para esse destino Indisponível para esse 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 – identificador; 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 programação como destinatário Indisponível para esse destino Indisponível para esse destino Indisponível para esse 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 esse destino Limite Limite Limite
Indisponível para esse 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 programação como destinatário Indisponível para esse destino Indisponível para esse destino Indisponível para esse 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 programação como destinatário Indisponível para esse destino Indisponível para esse destino Indisponível para esse 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 de envio do conteúdo do Look somente quando determinadas condições são atendidas. Os alertas têm uma função semelhante para os blocos do painel.

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

Também é possível especificar que haja uma exibição somente se os resultados da consulta tiverem mudado 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

É possível limitar o tamanho da exibição selecionando uma das seguintes opções de limite para seus dados:

  • Resultados na tabela:os dados são enviados como um único envio.
  • Todos os resultados:os dados são transmitidos. Saiba mais na seção Quais são todos 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 obedecerá às limitações de linha configuradas no Look ou na Análise. Se você escolher Todos os resultados, o Looker retornará todas as linhas da consulta, independentemente das configurações de Look salvas e do limite típico de 5.000 linhas do Looker. Isso pode ser desejável para recuperar conjuntos de dados muito grandes, mas você deve ter cuidado para garantir que a consulta não seja muito grande para o seu banco de dados.

Limitar as opções de e-mail

Ao enviar Looks e Explores, você pode limitar o tamanho do e-mail para não ultrapassar os limites de tamanho de mensagem 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 dos 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. No entanto, existe um limite de dados de 15 MB para que os aplicativos de e-mail aceitem o anexo. E-mails com mais de 15 MB com anexo não serão enviados. Quando você especifica um formato de tabela de dados ou visualização e seleciona Todos os resultados, o Looker muda automaticamente o formato para usar um anexo de texto, que permite o envio de todos os resultados.

Para verificar se você está dentro do limite de linhas ou dados dos 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ê imediatamente. Se você não recebeu o e-mail, é provável que tenha atingido o limite de linhas ou de dados.

Opções de e-mail

As entregas por e-mail têm outras opções de entrega, conforme descrito abaixo.

Executar programação como destinatário

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

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

Por exemplo, um administrador do Looker precisa programar um relatório que conta os Usuários agrupados por Estado para uma série de usuários, cada um com valores diferentes no 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 for selecionada, a consulta programada aplicará o filtro de acesso users.state = 'California' e enviará os resultados filtrados ao 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 criou a programação, bem como os tipos de endereços de e-mail adicionados ao campo de texto Para quem a programação deve ser enviada?.

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

  1. Quando um usuário que não é administrador adiciona um endereço de e-mail diferente do 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 foi adicionado antes da opção Executar programação como destinatário ser selecionada, ela será desativada automaticamente. Ele ficará disponível novamente se o 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 ser selecionada, a adição do endereço de e-mail vai gerar 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 permanecer ativada.

No caso especial em que um usuário está listado como um destinatário em uma programação com a opção Executar programação como destinatário ativada e a conta dele é desativada, a programação não será entregue para o usuário desativado na próxima vez que for executada. Se a conta do usuário for excluída, a programação inteira não será entregue a nenhum destinatário. Um administrador ou usuário do Looker com a permissão see_schedules vai poder diagnosticar essa falha na página Histórico do programador do 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 retorno para o Looker, que diz "Ver relatório completo" para Looks e Explores enviados e "Ver painel completo" para os painéis enviados.

Esse link permite que os destinatários do e-mail explorem os dados na sua instância do Looker. Os destinatários precisam fazer login no Looker e ter permissões para acessar o modelo no qual o conteúdo enviado se baseia para visualizar esse conteúdo no Looker. 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 opções adicionais de entrega, conforme descrito abaixo.

Aplique opções de visualização

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

Valores de dados formatados

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

Você pode configurar a formatação dos dados:

  • Selecione Valores de dados formatados se você quiser que os dados apareçam de maneira mais semelhante à 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 você 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 aplicado. 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, você pode personalizar a largura da visualização 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, talvez os destinatários do e-mail precisem rolar horizontalmente para visualizar a visualização completa.

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 tem um fuso horário associado à sua conta, o Looker usa o fuso horário do aplicativo. Se 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 envio único de teste ao destino especificado.

Salvando a entrega

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

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

No caso de envios recorrentes, ao 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á enviado de acordo com suas configurações de exibição. Se você reabrir o Programador, a programação salva aparecerá no painel esquerdo. Você tem a opção de duplicar ou excluir a programação clicando no ícone Duplicar ou Excluir, respectivamente.

Sua programação salva também aparecerá na página Programações que você criou no seu 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 as entregas

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

Como visualizar as entregas criadas por você

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

Visualizar as entregas criadas por outros usuários

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

Informações úteis

Às vezes, uma entrega programada de e-mails pode não atingir um ou mais destinatários. Isso pode acontecer se o modelo subjacente tiver um erro, o destinatário não tiver acesso aos dados ou se houver problemas de renderização ou erros na página.

Alguns 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 verificar se as definiçõ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, é 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 tabelas derivadas persistentes sendo construídas. Se isso acontecer, consulte seus 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 desse e-mail programado. Isso 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 individual pode cancelar a inscrição em todo o alias de e-mail. Se você quiser entender os cancelamentos de assinatura, confira esta postagem da comunidade do Looker sobre como monitorar eventos de cancelamento de inscrição do programador.