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 Como programar e enviar painéis.
O programador do Looker é o nome da janela pop-up em que você define as configurações do envio de conteúdo. Para Looks, é possível usar o Programador para enviar entregas únicas ou recorrentes. As análises detalhadas só podem ser enviadas como entregas únicas. Para programar a entrega recorrente de conteúdo da Análise, primeiro salve-o como um Look.
Se você 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 em uma pasta
Para as análises detalhadas, você pode abrir o Programador apenas no Explorar, 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. Ao acessar uma pasta, todos os Looks e dashboards dela são listados na visualização de lista ou de 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 de 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 escolhendo Programar (para entregas recorrentes) ou Enviar (para entregas únicas).
Para envios recorrentes, o painel esquerdo do Agendador legado mostra todos os agendamentos criados para o conteúdo e destaca o título do agendamento que você está criando ou editando. O painel esquerdo lista as programações em ordem cronológica inversa, a partir da última atualização. É possível duplicar ou excluir programações clicando no ícone 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, selecione-a e mude as opções conforme necessário. Quando terminar, clique em Salvar tudo.
- Para criar outras programações para o mesmo conteúdo, clique em 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 à sua programação. O título vai aparecer no painel à esquerda depois que você salvar a programação, na lista de programações criadas e nas páginas de gerenciamento de programação no painel Administrador.
Dependendo do destino da entrega, o título também pode aparecer em outros lugares:
- Para 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 Title.
- Para envios a um bucket do Amazon S3, o título é usado no nome do arquivo do envio e em todos os e-mails de erro enviados. O nome do arquivo da entrega segue o formato
TITLE_TIMESTAMP_HASH, em queHASHé um identificador aleatório de seis caracteres eTIMESTAMPsegue o padrãoYYYY-MM-DDTHHMM(por exemplo, a parte do carimbo de data/hora seria2019-05-31T0933para 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 a serviços integrados que geram um anexo de arquivo, o título é incluído no nome do arquivo do envio.
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 queTOKENé um identificador aleatório de seis caracteres eTIMESTAMPsegue o padrãoYYYY-MM-DDTHHMM(por exemplo, a parte do carimbo de data/hora seria2019-05-31T0933para 31 de maio de 2019 às 9h33). O fuso horário do carimbo de data/hora vai corresponder ao fuso horário de envio da programação.Para envios 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 estejam visíveis.
A configuração Para onde esses dados devem ser enviados? pode mostrar várias opções de destino para as entregas de dados. Cada destino oferece opções de entrega diferentes.
Os destinos incluem:
- webhook
- Bucket do Amazon S3
- SFTP
- Todos os serviços integrados que o administrador da Looker ativou para sua instância. Você pode conferir uma lista de serviços disponíveis para exibição de Looks e Análises na seção Opções de exibição para integrações de terceiros desta página.
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 ser enviados?. Seu conteúdo será enviado para uma lista de endereços de e-mail que você especificar.
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, talvez você possa enviar e-mails para endereços não associados a nenhuma conta de usuário na sua instância do Looker. Eles são classificados como e-mails externos. Para enviar conteúdo a usuários externos, o administrador do Looker precisa ter concedido permissões a você 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 vai ter a opção de vincular de volta ao painel no 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 de e-mail programada, essa programação será excluída do Looker, mesmo nas páginas de gerenciamento de programação para usuários e administradores. Se um destinatário cancelar a inscrição em nome de um grupo de e-mails, nenhum membro do grupo 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 Incluir uma mensagem personalizada para adicionar uma mensagem personalizada no corpo do e-mail. O Looker limita o número de caracteres em uma mensagem personalizada a 1.500.
As entregas por e-mail não podem exceder 20 MB (para formatos enviados no corpo do e-mail) e 15 MB (para formatos enviados como anexo).
Opções de 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, é possível 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 lidar com o webhook. Para configurar um webhook, acesse seu serviço da Web e faça o seguinte:
- Consiga um URL para onde o Looker deve enviar uma solicitação HTTPS.
- Especifique um aplicativo de destino para a entrega de dados do Looker. O aplicativo de destino pode exigir mais configurações para receber dados do Looker.
O procedimento exato varia de acordo com o serviço da Web e o aplicativo de destino que você está usando para exibir o painel. Consulte esta postagem da Comunidade do Looker sobre Como programar visualizações e painéis usando webhooks (3.46+) para conferir diretrizes sobre como configurar outro aplicativo para receber os dados do webhook do Looker.
O Looker 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 maneira 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 vai solicitar outras configurações sobre 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 seu bucket do Amazon S3:
- Bucket: o nome do bucket do Amazon S3.
- Caminho opcional: a pasta em que você quer salvar seus dados, se houver.
- 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 esses dados devem ser enviados? para enviar o 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 vai solicitar o endereço, o nome de usuário e a senha do servidor SFTP, conforme descrito a seguir.
Observe o seguinte sobre as entregas por 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 do arquivo. 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/
Este exemplo de URL termina com o caractere
/. Isso indica que o arquivo será salvo em uma pasta chamadaIn. Se você deixar o/final de fora, o arquivo será salvo na pastaMarketinge "In" será adicionado ao início do nome do arquivo. Você precisa ter acesso de gravação à pasta em que quer criar o arquivo.Nome de usuário e Senha: credenciais de login do servidor SFTP
Algoritmo de troca de chaves preferido: 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-sha1diffie-hellman-group1-sha1diffie-hellman-group14-sha1diffie-hellman-group-exchange-sha256
Se a conexão não for estabelecida em cinco minutos, escolha um algoritmo diferente. Alguns algoritmos demoram muito para gerar uma chave SSH. Essa opção permite usar um algoritmo que pode levar menos tempo. A escolha de um dos algoritmos faz com que ele seja o preferido para estabelecer a conexão SSH. Se o algoritmo não for suportado pelo servidor, 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 a SFTP está limitado a credenciais de nome de usuário e senha. Não há suporte para credenciais de chave privada SSH.
Os algoritmos de chave de host aceitos pelos envios de SFTP do Looker são os seguintes:
ssh-rsassh-dssssh-rsa-cert-v01@openssh.comssh-rsa-cert-v00@openssh.com
O Looker armazena impressões digitais SFTP para seu servidor SFTP. Se você encontrar erros na entrega do SFTP, isso pode indicar que as impressões digitais do SFTP estão inválidas. Nesse caso, entre em contato com o administrador do Looker.
O erro
Java::JavaLang::NullPointerExceptionsao 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/configou/etc/ssh_confignem armazene chaves de host de EC em~/.sshno 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 do 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 - Um token que consiste em uma string aleatória de seis caracteres
- A extensão do arquivo
Por exemplo: Test_Schedule_2019-04-11T1130_HWkvys.csv
Opções de envio para integrações de terceiros
É possível programar ou enviar 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 usuários e incorporar usuários para enviar e programar dados para integrações de terceiros.
Quando um serviço integrado é selecionado no campo Destino do Programador, vários campos novos podem aparecer e solicitar mais informações.
A lista a seguir mostra os serviços do Hub de Ações da Looker para os quais você pode enviar uma Análise ou os resultados de uma Análise detalhada.
Confira como usar a lista:
- Os URLs mostrados na coluna Link para o arquivo README incluem 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 fornecem instruções sobre como enviar dados do Looker para o serviço integrado. Alguns desses artigos também contêm instruções de ativação.
- Tags do LookML obrigatórias lista todas as tags que precisam ser usadas com o parâmetro
tagsno modelo subjacente do conteúdo. - Tipo de ação: indica o nível de dados que o serviço integrado está enviando: campo, consulta ou painel. Uma ação 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 detalhada ou um Look. Uma ação no nível do painel envia uma 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 streaming de dados (Sim/Não) |
|---|---|---|---|---|---|---|---|
| Airtable | Adicione registros a uma tabela no Airtable. | Conferir 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 | Inicie um job de treinamento no Amazon SageMaker usando o algoritmo de aprendizagem linear. | Nenhum README disponível | Nenhum artigo disponível | Nenhum | Consulta | Não | Sim |
| Amazon SageMaker Train: Xgboost | 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 interrupção do EC2 da Amazon Web Services | Pare uma instância do EC2 usando a API Amazon EC2. | Conferir 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. | Conferir o README no GitHub | Consulte o README | Nenhum | Consulta | Não | Sim |
| Armazenamento do Azure | Envie e armazene um arquivo de dados no Azure Storage. | Ver o README no GitHub | Conferir 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. |
Conferir o README no GitHub | Consulte o README | braze_id | Consulta | Não | Sim |
| DataRobot | Envie dados para o DataRobot e crie um novo projeto. | Conferir o README no GitHub | Consulte o arquivo README | Nenhum | Consulta | Não | Sim |
| DigitalOcean — gota de parada | Interrompa o processo da DigitalOcean usando a API da DigitalOcean. | Ver o README no GitHub | Confira o artigo da comunidade | digitalocean_droplet_id | Campo, consulta | Não | Não |
| Espaços da DigitalOcean | Enviar e armazenar um arquivo de dados no DigitalOcean Storage. | Ver o README no GitHub | Confira o artigo da comunidade | Nenhum | Consulta | Não | Sim |
| Dropbox | Enviar e armazenar um arquivo de dados no Dropbox. | Nenhum README disponível | Consulte a documentação | Nenhum | Consulta | Sim | Não |
| Públicos-alvo personalizados do Facebook | 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 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 | Faça upload de 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 | Faça upload de dados para um conjunto de dados do Google Analytics. | Ver o README no GitHub | Consulte o README | Nenhum | Consulta | Sim | Sim |
| Google Cloud Storage | Grave arquivos de dados em um bucket do Google Cloud Storage. | Conferir o README no GitHub | 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 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 um arquivo das Planilhas 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. | Conferir o README no GitHub | Consulte o README | Consulte o README | Consulta | Não | Sim |
| Campanhas do Salesforce | Adicione contatos ou leads à campanha do Salesforce. | 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 seus grupos de segmentos. | Conferir o README no GitHub | Consulte a documentação | segment_group_id e user_id ou segment_group_id e segment_anonymous_id | Consulta | Não | Sim |
| Segment Identify | Adicione características aos usuários da sua segmentação usando a API Identify. | Conferir o README no GitHub | Consulte a documentação | email, user_id, segment_anonymous_id ou segment_group_id | Consulta | Não | Sim |
| Trilha do segmento | Conecte-se a várias integrações fornecidas pelo Segment para identificar e segmentar usuários para fluxos de trabalho de marketing. | Ver o README no GitHub | Consulte a documentação | email, user_id, segment_anonymous_id ou segment_group_id | Consulta | Não | Sim |
| SendGrid | Envie dados e programe o envio de resultados para um endereço de e-mail usando a API do SendGrid. | Conferir o README no GitHub | 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 |
| Apêndice do Slack (token de API) | Envie dados diretamente para um canal do Slack com as credenciais do usuário. Consulte também a documentação do Lookerbot para conferir outras funcionalidades do Slack. | Ver o README no GitHub | Consulte a documentação | Nenhum | Consulta | Não | Não |
| Equipes: webhook de entrada | Envie dados para o Microsoft Teams usando um webhook de entrada. | Ver o README no GitHub | Consulte o 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. | Conferir o README no GitHub | Conferir 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. | Conferir o README no GitHub | Conferir o artigo da Comunidade | Nenhum | Consulta | Não | Não |
| Twilio: enviar mensagem | Envie uma mensagem para uma série de números de telefone (colunas de dados marcadas como números de telefone) em um Look. | Conferir 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 |
Como 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.
Os Looks e os Insights apresentam opções de formatação diferentes dependendo do destino de entrega. Para escolher o formato da entrega, selecione o ícone apropriado na seção Formatar dados como do Programador.
Consulte a tabela a seguir para uma explicação de como cada formato é entregue a cada destino.
| Formato | Webhook | Amazon S3 | SFTP | |
|---|---|---|---|---|
| Tabela de dados | A tabela de dados no corpo do e-mail em formato HTML | Indisponível para este destino | Indisponível para este destino | Indisponível para este destino |
| Visualização | A visualização no corpo do e-mail como uma imagem PNG | Indisponível para este destino | Indisponível para este destino | Indisponível para este destino |
| CSV | A tabela de dados como um anexo de arquivo de texto separado por vírgulas | A tabela de dados como um anexo de arquivo de texto separado por vírgulas | A tabela de dados como um anexo de arquivo de texto separado por vírgulas | A tabela de dados como um anexo de arquivo de texto separado por vírgulas |
| XLSX | A tabela de dados como um anexo de arquivo do Excel | A tabela de dados como um anexo de arquivo do Excel | A tabela de dados como um anexo de arquivo do Excel | A tabela de dados como um anexo de arquivo do Excel |
| JSON — Simples | A tabela de dados como um anexo de arquivo JSON. Nesse formato, o Looker usa o nome de um campo de dimensão ou métrica como o valor renderizado em vez do rótulo do campo. | A tabela de dados como um anexo de arquivo JSON. Nesse formato, o Looker usa o nome de um campo de dimensão ou métrica como o valor renderizado em vez do rótulo do campo. | A tabela de dados como um anexo de arquivo JSON. Nesse formato, o Looker usa o nome de um campo de dimensão ou métrica como o valor renderizado em vez do rótulo do campo. | A tabela de dados como um anexo de arquivo JSON. Nesse formato, o Looker usa o nome de um campo de dimensão ou métrica como o valor renderizado em vez do rótulo do campo. |
| JSON: rótulo | Indisponível para este destino | A tabela de dados no formato JSON. Nesse formato, o Looker usa rótulos de campo como o valor renderizado na saída JSON. | Indisponível para este destino | Indisponível para este destino |
| JSON — Simples, Inline | Indisponível para este destino | A tabela de dados enviada diretamente no formato JSON. Nesse formato, o Looker usa o nome do campo de uma dimensão ou medição 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 medição como valor renderizado em vez do rótulo do campo. | A tabela de dados enviada diretamente no formato JSON, com detalhes adicionais, como metadados de campo, informações de cache, o horário em que a consulta foi concluída e o tempo que a consulta levou para ser executada. Nesse formato, o Looker usa o nome do campo de uma dimensão ou medição como valor renderizado em vez do rótulo do campo. | A tabela de dados enviada diretamente no formato JSON, com detalhes adicionais, como metadados de campo, informações de cache, o horário em que a consulta foi concluída e o tempo que a consulta levou para ser executada. Nesse formato, o Looker usa o nome do campo de uma dimensão ou medição 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ção | A tabela de dados como um anexo de arquivo de texto delimitado por tabulação | A tabela de dados como um anexo de arquivo de texto delimitado por tabulação | A tabela de dados como um anexo de arquivo de texto delimitado por tabulação |
| HTML | A tabela de dados como um anexo de arquivo HTML | A tabela de dados como um anexo de arquivo HTML | A tabela de dados como um anexo de arquivo HTML | A tabela de dados como um anexo de arquivo HTML |
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 recorrente: 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 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 as 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 datagroup. O Looker lista todos os grupos de dados definidos nos modelos incluídos no bloco do Look ou do painel, mesmo que eles não sejam usados para lidar com o armazenamento em cache de consultas ou PDTs.
Os agendamentos com base em grupos de dados só são acionados para envio depois que o processo de regeneração é concluído para todos os PDTs que são mantidos com esse grupo, garantindo que o envio inclua os dados mais atualizados.
Como especificar a recorrência de envio
Você não verá essa opção ao enviar uma Análise, uma entrega única de um Look ou se tiver especificado um gatilho de atualização de grupo de dados para sua entrega recorrente.
Para entregas que usam um intervalo recorrente, é possível personalizar o horário da sua programação na seção Entregar essa programação. Selecione Intervalo recorrente na seção Acionar do Agendador. As opções de tempo mudam dependendo se você escolhe Diário, Semanal, Mensal, Por hora ou Por minuto. É possível ajustar o fuso horário da programação na seção Opções avançadas.
O horário de término dos intervalos Por hora e Por minuto não é incluído. A última entrega será enviada no último intervalo selecionado antes do horário de término especificado. Por exemplo, se o conteúdo for programado A cada hora entre 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.
Como aplicar filtros à entrega
Você não vai ter essa opção ao enviar uma Análise.
Se você estiver exibindo um Look ou painel com filtros, poderá modificar as condições de filtro para filtrar ainda mais os resultados.
Clique em Filtros para conferir e modificar os filtros associados a esse Look ou ao dashboard para sua exibição. Alterar essas opções de filtro no Programador não altera 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 exibição.
Se você mudar os nomes de campos que servem como filtros nos seus Looks ou painéis, revise a seção Filtros dos seus Looks e painéis programados e atualize os filtros conforme necessário para refletir as mudanças. Se uma entrega de conteúdo programada incluir filtros que não funcionam mais (por exemplo, se o campo referenciado foi alterado), a entrega programada poderá expor dados não filtrados.
Para personalizar ainda mais 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.
Como aplicar opções avançadas de entrega
A seção Opções avançadas oferece mais personalização para sua entrega. Clique na seta ao lado de Opções avançadas para abrir o menu. As opções disponíveis dependem do destino e do formato selecionados e se você está enviando um painel, uma Análise ou uma Análise detalhada. Os links na tabela a seguir direcionam para uma descrição de cada opção disponível para envios de Looks ou Análises para os destinos integrados do Looker. Os envios para integrações de terceiros podem ter opções avançadas exclusivas disponíveis.
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 essa programação se, especifique se você quer enviar o conteúdo do Look apenas se houver resultados, apenas se não houver resultados ou se houver ou não resultados. Por exemplo, é possível usar filtros para criar condições para situações que você quer monitorar, como itens abaixo de uma determinada quantidade 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
Para limitar o tamanho da entrega, selecione uma das seguintes opções de limite para seus dados:
- Resultados na tabela: os dados são enviados como uma única entrega.
- Todos os resultados: os dados são transmitidos por streaming. Consulte mais informações em Quais são todos os limites de linha no Looker? práticas recomendadas). Isso é útil para grandes conjuntos de dados, porque ignora as limitações de tamanho de arquivo, navegador e memória.
Se você escolher Resultados na tabela, o Looker vai obedecer às limitações de linha configuradas no Look salvo ou na Análise. Se você escolher Todos os resultados, o Looker vai retornar todas as linhas da consulta, independentemente das configurações salvas do Look e do limite típico de 5 mil linhas do Looker. Isso pode ser ú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, é possível enviar todas as linhas dos resultados de um Look salvo. Essa opção ignora os limites definidos em um Look salvo ou no limite típico de 5.000 linhas do Looker. No entanto, existe um limite de dados de 15 MB para que os apps de e-mail aceitem o anexo. E-mails com mais de 15 MB e anexos não são enviados. Se você especificar um formato de tabela de dados ou visualização e selecionar Todos os resultados, o Looker vai mudar automaticamente o formato para usar um anexo de texto para enviar 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: Executar programação como destinatário e Incluir links.
Executar programação como destinatário
Essa opção está disponível apenas para o destino 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 deles. 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 uma consulta que conte os usuários agrupados por Estado para uma série de usuários, e cada usuário tem valores de filtro de acesso diferentes.
O usuário A tem um filtro de acesso definido como users.state = 'California'. Quando a opção Executar programação como destinatário é selecionada, a consulta programada aplica o filtro de acesso users.state = 'California' e envia os resultados filtrados para o usuário A. Os resultados 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:
- Quando um usuário que não é administrador adiciona um endereço de e-mail que não é o seu
- Quando um administrador do Looker adiciona o e-mail de um usuário desativado
- 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 permanecer ativada.
No caso especial em que um usuário é listado como destinatário em uma programação com a opção Executar programação como destinatário ativada e a conta desse usuário é desativada, a programação não será entregue ao usuário desativado a partir da próxima execução. Se a conta desse usuário for excluída, toda a programação vai falhar na entrega para os destinatários. Um administrador ou usuário do Looker com a permissão see_schedules poderá diagnosticar essa falha na página Histórico do programador no painel Administrador.
Incluir links
Se o administrador do Looker tiver definido a política de dados enviados por e-mail da sua 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
As entregas que não usam o formato de visualização têm outras opções de envio, que são Aplicar opções de visualização e Valores de dados formatados.
Aplique opções de visualização
Essa opção não está disponível para envios de Look ou Explore no formato de visualização.
Selecione Aplicar opções de visualização para que o envio de dados pareça com um gráfico de tabela. Qualquer uma das seguintes configurações nos menus Enredo, Série e Formatação configurados para a visualização será aplicada:
- Mostrar números de linha
- Ocultar totais
- Ocultar totais das linhas
- Limitar linhas mostradas a um máximo de 500 linhas mostradas ou ocultas
- Mostrar nome completo do campo
- Rótulos personalizados para cada coluna. O formato JSON — detalhe, inline sempre usa nomes de campo brutos, não o rótulo do campo. Consulte a postagem da comunidade Mudança no formato JSON para mais informações sobre como o Looker renderiza campos no formato JSON.
- Formatação condicional para envios de visualizações de gráficos de tabela no formato Excel
A formatação condicional só aparece nos envios de Looks e Análises no Excel com gráficos de tabela quando a regra Ao longo de uma escala é aplicada.
Desmarque a opção Aplicar opções de visualização para que o Looker envie os dados conforme aparecem na seção Dados do Look ou na janela Explorar a partir daqui de um bloco do painel. JSON: rótulo usa o campo rótulo, mesmo que a opção Aplicar opções de visualização não esteja selecionada.
Valores de dados formatados
Essa opção não está disponível para envios de Look ou Explore 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 você não quiser aplicar nenhuma formatação especial nos resultados da consulta, como arredondar números longos ou adicionar caracteres especiais que os desenvolvedores do Looker possam ter aplicado. Isso geralmente é preferível quando os dados são enviados para processamento em outra ferramenta.
Resolução da tabela
Ao enviar conteúdo para e-mail no formato de visualização, é possível personalizar a largura usando o menu suspenso Resolução da tabela. Estas são as opções de largura:
- Normal: 800 pixels
- Grande: 1680 pixels
Se você escolher Amplo e a largura da visualização exceder o limite definido pelo seu cliente de e-mail, os destinatários da entrega de e-mails talvez precisem rolar horizontalmente para ver toda a visualização.
Fuso horário
Por padrão, o Looker usa o fuso horário associado à sua conta para determinar quando enviar 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 Enviar teste para enviar uma entrega de teste única para o destino especificado.
Salvar a entrega
Um resumo das suas configurações de envio é exibido na parte de baixo 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. Você pode duplicar ou excluir a programação clicando no ícone Duplicar ou Excluir, respectivamente.
A programação salva também vai aparecer na página Programações criadas no seu perfil de usuário e nas páginas Programações e Histórico de programação no painel Administrador. Consulte a seção Como conferir as entregas nesta página para mais informações.
Como visualizar envios
Você pode conferir as programações que criou e, com as permissões adequadas, todas as programações da instância do Looker.
Exibição de entregas que você criou
Você pode conferir uma lista de todas as programações criadas na página Programações criadas. Para acessar essa página, clique no ícone do seu perfil de usuário e selecione Programações. Consulte a página Como visualizar suas entregas de dados programadas para mais informações sobre como visualizar e gerenciar as programações que você criou.
Como conferir entregas criadas por outros usuários
Se o administrador do Looker tiver concedido permissões para visualização das 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 é 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 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 do que esses limites não serão enviados.
- Se um e-mail não for enviado no horário esperado, mas chegar eventualmente, provavelmente é porque você está competindo com outras tarefas do Looker. Essas tarefas podem incluir outros e-mails programados, muitas pessoas analisando dados ao mesmo tempo ou tabelas derivadas persistentes sendo criadas. Se isso acontecer, 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. Isso pode ser um desafio se você usar um alias de e-mail de grupo para enviar para várias pessoas, porque qualquer destinatário individual pode cancelar a inscrição em todo o alias de e-mail. 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.