Como enviar Looks e Explores

Nesta página, você terá 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 informações sobre a programação de painéis, acesse a página de documentação Programação e envio de painéis.

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

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

Como abrir o Programador em uma pasta

Para "Explores", você só pode 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 entregar. Quando você navega até uma pasta, todos os Looks e dashboards dentro dela são listados na list view ou grid view.

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 das seguintes formas:

  • 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 da seguinte forma:

  • 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 selecionando 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 à esquerda lista as programações em ordem cronológica inversa da data da última atualização. É possível duplicar ou excluir programações clicando no ícone Duplicar ou Excluir à direita da programação.

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. Modifique 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 existente, selecione-a e altere as opções. Quando terminar, clique em Salvar tudo.
  • Para criar outras programações para o mesmo conteúdo, clique em Novo + e insira as configurações da 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 à sua programação. O título aparecerá no painel à esquerda depois que você salvar a programação, na lista de programações criadas e nas páginas de gerenciamento de programações do painel Administrador.

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

  • Nas 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.
  • No caso de entregas a um bucket do Amazon S3, o título é usado no nome do arquivo da entrega e em todos os 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 de arquivo, o título é incluído no nome do arquivo do envio.

  • Para envios SFTP, o título é incluído no nome do arquivo. 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 aceitos no nome do arquivo do envio. O Looker vai remover todos os caracteres diferentes de A-Z, a-z, 0-9, _ ou - do que você inseriu no campo Dê um nome à sua programação.

Escolher o destino de entrega

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

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

Os destinos incluem:

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

Opções de entrega de e-mail

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

Na seção Para quem as mensagens devem ser enviadas, digite os endereços de e-mail dos destinatários. Digite um ou vários endereços 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 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 a você permissões para enviar conteúdo para usuários externos ou ter adicionado os domínios de e-mail desses destinatários à permissão de domínios 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 vincular novamente ao painel pelo e-mail, a menos que o administrador do Looker tenha definido a política de dados enviados por e-mail da sua instância do Looker para 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 vai ser excluída do Looker, mesmo nas páginas de gerenciamento de programações para usuários e administradores. Se um destinatário cancelar a inscrição em nome de um grupo de e-mails, nenhum membro do grupo receberá entregas programadas.

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.

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 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 grande variedade de aplicativos. Por exemplo, é possível programar a entrega periódica de um Look ou dashboard em 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 deve enviar uma solicitação HTTPS para essa entrega. Você pode encontrar esse URL no serviço da Web que está usando para processar o webhook. Para configurar um webhook, acesse seu serviço da Web e faça o seguinte:

  1. Consiga um URL em que o Looker precisa enviar uma solicitação HTTPS.
  2. Especifique um aplicativo de destino para sua entrega de dados do Looker. O aplicativo de destino pode exigir configuração adicional 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 fornecer o painel. Confira esta postagem na Comunidade do Looker sobre Como programar Looks e painéis usando webhooks (3,46 ou mais) para conferir diretrizes sobre como configurar outro aplicativo para receber os dados do webhook do Looker.

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

Opções de entrega para buckets do Amazon S3

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

Se você escolher a opção de destino do Amazon S3, o Looker vai solicitar configurações adicionais sobre a formatação e o bucket do Amazon S3, conforme descrito nesta página. Confira esta postagem da comunidade do Looker sobre Programação (ilimitado) de resultados para S3 se quiser mais detalhes sobre a entrega de dados usando um bucket do Amazon S3.

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

  • Bucket: o nome do seu bucket do Amazon S3.
  • Caminho opcional: a pasta em que você quer salvar os dados, se houver.
  • Chave de acesso: o ID da chave de acesso ao 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 onde seu bucket do S3 está hospedado.

Opções de entrega para servidores SFTP

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

Observações sobre os envios por SFTP:

  • Para receber envios de SFTP do Looker, verifique se o administrador da 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, somente os caracteres alfanuméricos, sublinhado (_) e hífen (-) são aceitos no nome do arquivo. O Looker vai remover todos os caracteres diferentes de A-Z, a-z, 0-9, _ ou - do que você inseriu no campo Dê um nome à sua 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 seus dados. Exemplo:

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

    Este 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á anexado ao 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 preferencial: este campo é opcional. Para configurar, 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 pode levar menos tempo. Escolher 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ões é usada.

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

Os principais algoritmos de host com suporte nas entregas 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 seu servidor SFTP. Caso encontre erros no envio do SFTP, é possível que as impressões digitais do SFTP sejam 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, na sigla em inglês) e/ou chaves de host para conexões SSH do Looker para destinos SFTP. Para evitar problemas com o envio de dados a 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 seu 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 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 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 exibição para integrações de terceiros

Você pode programar ou enviar um Look ou os resultados de um Explore para um serviço integrado ao Looker, como o Slack, o Dropbox, o Google Drive e outros. As integrações precisam ser ativadas pelo administrador do Looker. Os administradores do Looker precisam conceder permissões especificamente para que usuários e usuários incorporados enviem e programem dados para integrações de terceiros.

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

A lista a seguir mostra os serviços do Hub de ações do Looker a que você pode enviar um Look ou os resultados de uma Análise.

Veja como usar a lista:

  • Os URLs mostrados 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 mostrados na coluna Como usar esta integração dão instruções sobre como enviar dados do Looker para o serviço integrado. Alguns artigos também contêm instruções de ativação.
  • Tags LookML obrigatórias listam todas as tags obrigatórias que precisam ser usadas com o parâmetro tags no modelo subjacente do conteúdo.
  • Tipo de ação indica qual nível de dados 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 de um Explore ou Look. Uma ação no nível do painel envia a imagem de um painel.
  • Usa a autenticação OAuth do Google indica se o serviço integrado usa as credenciais do Google OAuth para autenticação.
  • Usa 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)
Mesa de ar Adicione registros a uma tabela no Airtable. Veja o README no GitHub Leia o artigo da comunidade Nenhum Consulta Não Não
Inferência do Amazon SageMaker Realize uma inferência usando o Amazon SageMaker. Nenhum README disponível Nenhum artigo disponível Nenhum Consulta Não Sim
Amazon SageMaker Train: estudante linear Iniciar um job de treinamento no Amazon SageMaker usando o algoritmo de aprendizado linear Nenhum README disponível Nenhum artigo disponível Nenhum Consulta Não Sim
Amazon SageMaker Train: Xgboost Inicie um job de treinamento no Amazon SageMaker usando o algoritmo Xgboost. Nenhum README disponível Nenhum artigo disponível Nenhum Consulta Não Sim 5.6
Instância de interrupção do Amazon Web Services EC2 Interrompa uma instância do EC2 usando a API Amazon EC2. Veja o README no GitHub Leia o artigo da comunidade aws_resource_id Campo, consulta Não Não
Trado Usa o resultado da consulta para criar um modelo preditivo. Veja o README no GitHub Consulte o README Nenhum Consulta Não Sim
Armazenamento do Azure Envie e armazene um arquivo de dados no Armazenamento do Azure. Veja o README no GitHub Leia o artigo da comunidade Nenhum Consulta, painel Não Sim
Braze A ação Braze permite sinalizar usuários no Braze usando o endpoint da API REST em um Look. Verifique se há um campo braze_id marcado nos resultados. EXPORTAÇÃO MÁXIMA: 10.000. Veja o README no GitHub Consulte o README braze_id Consulta Não Sim
DataRobot Enviar dados para o DataRobot e criar um novo projeto. Veja o README no GitHub Consulte o README Nenhum Consulta Não Sim
DigitalOcean — Parar Droplet Interromper o processo da DigitalOcean usando a API DigitalOcean. Veja o README no GitHub Leia o artigo da comunidade digitalocean_droplet_id Campo, consulta Não Não
Espaços da DigitalOcean Envia e armazena um arquivo de dados no DigitalOcean Storage. Veja o README no GitHub Leia o artigo da comunidade Nenhum Consulta, painel Não Sim
Dropbox enviar e armazenar um arquivo de dados no Dropbox; Nenhum README disponível Consulte a documentação Nenhum Consulta, painel Sim Não
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. Veja o README no GitHub Consulte o README Nenhum Consulta Sim Sim
Firebase Usar o Firebase para enviar notificações push a dispositivos móveis. Nenhum README disponível Nenhum artigo disponível Nenhum Consulta Não Não
Segmentação por lista de clientes do Google Ads Fazer o upload de dados para a Segmentação por lista de clientes do Google Ads. Veja o README no GitHub Consulte a documentação Nenhum Consulta Sim Sim
Importação de dados do Google Analytics Fazer upload dos dados para um conjunto de dados do Google Analytics. Veja 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. Veja o README no GitHub Leia o artigo da comunidade Nenhum Consulta, painel Não Sim
Google Drive Enviar dados para o Google Drive. Nenhum README disponível Consulte a documentação Nenhum Consulta, painel Sim Sim
Planilhas Google Enviar dados CSV para um Planilhas 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. Veja 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. Veja o README no GitHub Consulte o README hubspot_contact_id Consulta Não Sim
Kloudio Adicione dados a uma planilha Google. Veja o README no GitHub Consulte o README Nenhum Consulta Não Não
mParticle Exporte em massa os dados de usuários ou eventos do Looker para o mParticle. Veja o README no GitHub Consulte o README Consulte o README Consulta Não Sim
Campanhas do Salesforce Adiciona contatos ou leads à campanha do Salesforce. Veja o README no GitHub Consulte o 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. Veja o README no GitHub Consulte a documentação segmento_group_id e user_id ou segment_group_id e segment_anonymous_id Consulta Não Sim
Identificação de segmentos Adicione características aos usuários do seu segmento usando o recurso "Identificar". Veja o README no GitHub Consulte a documentação e-mail, user_id, segment_anonymous_id ou segment_group_id Consulta Não Sim
Faixa de segmento Conecte-se a uma série de integrações fornecidas pelo Segment para identificar e segmentar usuários para fluxos de trabalho de marketing. Veja o README no GitHub Consulte a documentação e-mail, user_id, segment_anonymous_id ou segment_group_id Consulta Não Sim
SendGrid Envie dados e programe resultados para enviá-los a um endereço de e-mail usando a API do SendGrid. Veja o README no GitHub Leia o artigo da comunidade Nenhum Consulta, painel Não Não
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](/looker/docs/admin-panel-server-ip-allowlist) desativado. Nenhum README disponível Consulte a documentação Nenhum Consulta, painel Sim Sim
Anexo do Slack (token de API) Envie dados diretamente para um canal do Slack junto com as credenciais do usuário. Consulte também a documentação do Lookerbot para mais funcionalidades do Slack. Veja o README no GitHub Consulte a documentação Nenhum Consulta, painel Não Não
Equipes: webhook de entrada Envie dados para o Microsoft Teams usando um webhook de entrada. Veja o README no GitHub Consulte o README Nenhum Consulta, painel Não Não
Bandeja Conecte-se a diversas integrações fornecidas pela Tray.io para automatizar fluxos de trabalho. Veja o README no GitHub Leia o artigo da comunidade Nenhum Consulta Não Sim
Twilio: enviar dados Use a API do Twilio para enviar dados de um Look ou agendar resultados para um número de telefone. Veja o README no GitHub Leia 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. Veja o README no GitHub Consulte o README phone Campo, consulta Não Não
Zapier Conecte-se às diversas integrações fornecidas pelo Zapier para automatizar fluxos de trabalho. Veja o README no GitHub Leia o artigo da comunidade Nenhum Consulta Não Sim

Como escolher o formato de dados

Para 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 sua instância do Looker como Enviar somente link.

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

Consulte a tabela abaixo para saber como cada formato é entregue a cada destino.

Formato E-mail Webhook Amazon S3 SFTP
Tabela de dados A tabela de dados no corpo do e-mail em formato HTML Indisponível para este destino Indisponível para este destino Indisponível para este destino
Visualização A visualização no corpo do e-mail como uma imagem PNG Indisponível para este destino Indisponível para este destino Indisponível para este destino
CSV A tabela de dados como um anexo de arquivo de texto separado por vírgulas A tabela de dados como um anexo de arquivo de texto separado por vírgulas A tabela de dados como um anexo de arquivo de texto separado por vírgulas A tabela de dados como um anexo de arquivo de texto separado por vírgulas
XLSX A tabela de dados como um anexo de arquivo do Excel A tabela de dados como um anexo de arquivo do Excel A tabela de dados como um anexo de arquivo do Excel A tabela de dados como um anexo de arquivo do Excel
JSON: simples A tabela de dados como um anexo de arquivo JSON. Nesse formato, o Looker usa o nome do campo de uma dimensão ou medida como 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: identificador Indisponível para este destino A tabela de dados no formato JSON. Nesse formato, o Looker usa rótulos de campo como o valor renderizado na saída JSON. Indisponível para este destino Indisponível para este destino
JSON: simples, inline Indisponível para este destino A tabela de dados enviada diretamente no formato JSON. Nesse formato, o Looker usa o nome do campo de uma dimensão ou medida como 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çã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

Acionamento da exibição

Essa opção não será exibida se você estiver enviando um Explore ou uma entrega única 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 exibição desta página.
  • Atualização do datagroup: se o desenvolvedor do LookML tiver configurado datagroups, será possível programar a entrega para ocorrer depois que um grupo for acionado, tiver gerenciado o cache e recriar as TDPs relevantes.

Como especificar o gatilho do datagroup

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

Para usar um acionador de datagroup, selecione Atualização do 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, mesmo que eles não sejam usados para processar o armazenamento em cache em 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 nesse grupo de dados, garantindo que a entrega inclua os dados mais atualizados.

Como especificar a recorrência de entrega

Essa opção não será exibida ao enviar um Explore, enviar um Look único ou especificar um acionador de atualização de grupo de dados para seu envio recorrente.

Para envios que usam um intervalo de repetição, é possível personalizar o horário 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 de tempo variam de acordo com sua escolha: Diariamente, Semanal, Mensal, Por 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 são incluídos. A última exibição será realizada 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 uma hora, a cada hora, das 00h às 22h. Se o conteúdo estiver programado Por minuto a cada 30 minutos entre 12h e 13h, o período de 13h às 13h será enviado em 12h.

Aplicar filtros à entrega

Essa opção não será exibida se você estiver enviando uma Análise.

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

Clique em Filtros para acessar e modificar os filtros associados a esse Look ou dashboard para sua exibição. Alterar 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 exibirá resultados após a exibição.

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

Para personalizar ainda mais as entregas, é possível usar 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 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 se enviar 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 expandir esse menu. As opções disponíveis dependem do destino e formato selecionados do envio e se você está enviando um dashboard, um Look ou um Explore. 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. As entregas para integrações de terceiros podem ter opções avançadas exclusivas disponíveis.

Formato E-mail Webhook Amazon S3 SFTP
Tabela de dados
Envie esta programação se Indisponível para este destino Indisponível para este destino Indisponível para este destino
Limite
Opções de e-mail Executar a programação como destinatário
Incluir links
Opções de formatação Aplique opções de visualização
Valores de dados formatados
Fuso horário
Visualização
Limite Indisponível para este destino Indisponível para este destino Indisponível para este destino
Opções de e-mail Executar a 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 a programação como destinatário Indisponível para este destino Indisponível para este destino Indisponível para este destino
Incluir links
Opções de formatação Aplique opções de visualização Opções de formatação Aplique opções de visualização Opções de formatação Aplique opções de visualização Opções de formatação Aplique 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 a programação como destinatário Indisponível para este destino Indisponível para este destino Indisponível para este destino
Incluir links
Opções de formatação Aplique opções de visualização Opções de formatação Aplique opções de visualização Opções de formatação Aplique opções de visualização Opções de formatação Aplique 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 a programação como destinatário Indisponível para este destino Indisponível para este destino Indisponível para este destino
Incluir links
Opções de formatação Aplique opções de visualização Opções de formatação Aplique opções de visualização Opções de formatação Aplique opções de visualização Opções de formatação Aplique opções de visualização
Valores de dados formatados Valores de dados formatados Valores de dados formatados Valores de dados formatados
Fuso horário Fuso horário Fuso horário Fuso horário
JSON: detalhado, inline Indisponível para este destino Limite Limite Limite
Indisponível para este destino Fuso horário Fuso horário Fuso horário
Texto
Envie esta programação se Envie esta programação se Envie esta programação se Envie esta programação se
Limite Limite Limite Limite
Opções de e-mail Executar a programação como destinatário Indisponível para este destino Indisponível para este destino Indisponível para este destino
Incluir links
Opções de formatação Aplique opções de visualização Opções de formatação Aplique opções de visualização Opções de formatação Aplique opções de visualização Opções de formatação Aplique 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 a programação como destinatário Indisponível para este destino Indisponível para este destino Indisponível para este destino
Incluir links
Opções de formatação Aplique opções de visualização Opções de formatação Aplique opções de visualização Opções de formatação Aplique opções de visualização Opções de formatação Aplique 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, apenas se não houver resultados ou se houver ou não houver resultados. Por exemplo, é possível usar filtros para criar condições em situações que você quer monitorar, como itens abaixo de uma determinada quantidade de inventário, despesas acima de um determinado valor etc., e só exibir o conteúdo se essa condição for atendida.

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

Limite

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

  • Resultados na tabela:os dados são enviados como uma entrega única.
  • 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 vai obedecer às limitações de linha configuradas no Look salvo 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. 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 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 Text, CSV, JSON — Simple, XLSX ou HTML, pode enviar todas as linhas de resultados de um Look salvo. Essa opção ignora os limites definidos em um Look salvo ou no limite típico de 5 mil linhas do Looker. No entanto, existe um limite de dados de 15 MB para que os apps de e-mail aceitem o anexo. E-mails com mais de 15 MB com anexo não serão enviados. Se você especificar um formato de tabela de dados ou visualização e selecionar Todos os resultados, o Looker vai mudar automaticamente o formato para usar um anexo de texto, que permite o envio de todos os resultados.

Para verificar se você está dentro do limite de linhas ou de 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 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 opções adicionais de entrega, conforme descrito abaixo.

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 vão receber o envio de conteúdo como se tivessem feito a consulta, com base nas permissões deles. Usuários que não são administradores também podem inserir o próprio endereço de e-mail para receber uma entrega, como se tivessem consultado o conteúdo, com base nas permissões deles. Isso significa que os filtros de acesso e os atributos do usuário de cada usuário serão aplicados aos dados incluídos em cada e-mail.

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

O usuário A tem um filtro de acesso definido como users.state = 'California'. Quando a opção Executar programação como destinatário for selecionada, a consulta programada vai aplicar o filtro de acesso users.state = 'California' e enviar os resultados filtrados para o usuário A. Os resultados mostrarão uma linha apenas para 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 mensagem deve ser enviada?.

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

  1. Quando um usuário que não é administrador adiciona um endereço de e-mail 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 tiver sido 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, a inclusão do endereço de e-mail vai gerar um erro, e o e-mail será removido automaticamente do campo A quem ele deve enviar e-mail?. A opção Executar programação como destinatário vai continuar ativada.

No caso especial em que um usuário está listado como destinatário em uma programação com a opção Executar programação como destinatário ativada e a conta dele for 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 não será entregue aos destinatários. Um administrador ou usuário do Looker com a permissão see_schedules pode 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 sua instância do Looker como Enviar links e dados, o programador vai mostrar a opção para Incluir links. Quando essa opção está marcada, os envios de dados por e-mail incluem um link de volta para o Looker que diz "Ver relatório completo" para Looks e Explores enviados e "Ver painel completo" para os dashboards enviados.

Com esse link, os destinatários do e-mail podem explorar 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 de base do conteúdo enviado 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 envio, conforme descrito abaixo.

Aplique opções de visualização

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

Valores de dados formatados

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

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

  • Selecione Valores de dados formatados se quiser que os dados tenham uma aparência mais semelhante à experiência Explorar no Looker, embora alguns recursos (como links) 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, é possível personalizar a largura da visualização usando o menu suspenso Resolução da tabela. Suas 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 seu cliente de e-mail, talvez os destinatários do envio de e-mails precisem rolar a tela horizontalmente para mostrar 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 tiver um fuso horário associado à sua conta, o Looker vai usar 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 seu Look ou dashboard, apenas o horário da exibição.

Como testar a entrega

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

Salvando a entrega

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

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

Para entregas recorrentes, quando você 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 aparece na página Programações que você criou no perfil de usuário e nas páginas Programações e Histórico de programações no painel Administrador. Consulte a seção Como visualizar entregas nesta página para mais informações.

Como visualizar 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 que você criou

É possível ver uma lista de todas as programações que você 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 ver e gerenciar as programações que você criou.

Como visualizar entregas criadas por outros usuários

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

Informações úteis

Às vezes, 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, se o destinatário não tiver acesso aos dados ou se houver problemas de renderização ou de 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 configurações estão corretas e se o provedor de e-mail está funcionando corretamente.
  • Dependendo da configuração Limite, a entrega de dados é 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 é enviado no horário esperado, mas chega depois, é 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 criadas. Se isso acontecer, converse com seus administradores do Looker sobre tarefas concorrentes.
  • Se um e-mail específico continua desaparecendo da sua lista de distribuição, é provável que um usuário esteja cancelando a inscrição desse e-mail programado. Esse pode ser um desafio específico se você usar um alias de e-mail de grupo para enviar e-mails para várias pessoas, já que qualquer destinatário individual pode cancelar a inscrição de todo o alias de e-mail. Se você precisar entender os cancelamentos de inscrição, confira esta postagem na Comunidade do Looker sobre como monitorar eventos de cancelamento de inscrição do programador (em inglês).