Esta página fornece uma visão geral de como exibir aparências e explorações para os destinos de entrega nativos do Looker e a qualquer serviço integrado disponível para sua instância do Looker. Para ver informações sobre a exibição de painéis legados, consulte a página de documentação Como exibir painéis legados. Para informações sobre a programação de painéis, acesse a página de documentação Como programar e enviar painéis.
O Looker Scheduler é o nome da janela pop-up em que você define as configurações para o envio de conteúdo. Na aparência, é possível usar o programador para enviar envios únicos ou recorrentes. As explorações só podem ser enviadas como entregas únicas. Para programar a exibição recorrente do Conteúdo Explorar, salve-o como um "Pré-lançamento".
Se você é um desenvolvedor do Looker, desative o Modo de desenvolvimento para ativar essas opções de programação.
As opções de entrega disponíveis dependem das permissões relacionadas à entrega concedidas pelo administrador do Looker.
Como abrir o programador de uma pasta
Em "Explorar", você pode abrir o programador somente em Explorar, não em uma pasta.
Para abrir o programador em uma pasta ou subpasta, encontre a pasta ou subpasta que contém o painel a ser exibido. Quando você navega para uma pasta, todas as aparências e painéis dentro da pasta são listados na visualização em lista ou na visualização de grade.
Se o administrador tiver ativado o recurso Labs Navigation avançado, será possível acessar as pastas expandindo a lista de pastas na seção Pastas do novo painel de navegação avançado à esquerda.
Um ícone de calendário indica que você programou pelo menos uma exibição recorrente para esse conteúdo. Na visualização em grade, passe o cursor sobre a miniatura do conteúdo para ver o ícone da agenda, se houver:
Na visualização em lista, é possível abrir o programador:
- Clicar no ícone de calendário 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 selecione Programar (para entregas recorrentes) ou Enviar (para entregas únicas).
Na visualização de grade, é possível abrir o programador:
- Clicar no ícone de calendário de um item, se houver
- Abra o conteúdo, clique no menu de engrenagem no canto superior direito e selecione Programar (para entregas recorrentes) ou Enviar (para entregas únicas).
Como criar uma entrega
Como só é possível enviar as explorações como entregas únicas, não há a opção Programar no menu de engrenagem.
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).
O Looker exibe o programador legado, um pop-up com suas opções de programação, semelhante a este, que mostra uma entrega programada de um painel legado para um e-mail no formato PDF:
O programador legado para entrega de um Look poderá ter esta aparência:
Para os envios recorrentes, o painel esquerdo do programador legado mostra todas as programações criadas para o conteúdo e destaca o título da programação que você está criando ou editando. O painel esquerdo lista as programações em ordem cronológica inversa, a partir da última atualização. É possível duplicar ou excluir programações existentes clicando no ícone Duplicar ou Excluir à direita da programação, respectivamente.
Se esta for a primeira programação que você está criando para este conteúdo, o painel principal exibirá opções de programação definidas para os valores padrão. Esses valores podem ser modificados como você quiser. Se você já tiver criado uma ou mais programações para esse conteúdo, o painel principal exibirá as configurações de programação salvas no início da lista. Depois, siga estas instruções:
- Para editar as opções de uma programação existente, selecione essa programação e altere-as conforme necessário. Quando terminar, clique em Salvar tudo.
- Para criar programações adicionais para o mesmo conteúdo, clique em Novo + e insira as configurações dessa programação adicional.
Quando terminar, clique em Salvar tudo.
As seções a seguir explicam cada configuração de programação.
Nomear a entrega
Dê um título exclusivo à programação no campo Dê um nome à programação. O título vai aparecer no painel esquerdo depois que você salvar a programação, na lista de programações criadas e nas páginas de gerenciamento de programações no painel Administrador.
Dependendo do destino da entrega, o título também poderá ser exibido em outros lugares:
- Nas entregas de e-mails, o título é usado para o assunto e como parte do nome do arquivo se você selecionar um formato que usa um anexo de e-mail.
- Para webhooks, o título é incluído no payload do webhook no campo Título.
- Para entregas em um bucket do Amazon S3, o título é usado no nome do arquivo de envio e nos 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). - Para entregas em serviços integrados que geram um anexo de arquivo, o título é incluído no nome de arquivo da entrega.
Para entregas em SFTP, o título está incluído no nome de arquivo da entrega. 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).Para entregas via SFTP, somente caracteres alfanuméricos, sublinhados (_) e hifens (-) são aceitos no nome de arquivo da entrega. O Looker excluirá todos os caracteres além dos caracteres
A-Z,a-z,0-9,_ou-inseridos no campo Dê um nome à sua programação.
Como escolher o destino da entrega
Dependendo de como o administrador do Looker configurou suas permissões, nem todos os destinos poderão ser visíveis.
A configuração Para onde esses dados devem ir? pode exibir várias opções de destino para entregas de dados. Cada destino oferece diferentes opções de entrega.
Os destinos incluem:
- webhook (em inglês)
- Bucket do Amazon S3
- SFTP
- Os serviços integrados que o administrador do Looker ativou para sua instância. Veja uma lista dos serviços disponíveis para a exibição de visualizações e explorações na seção Opções de entrega para integrações de terceiros desta página.
Depois de selecionar um destino de dados, um novo campo de configuração será exibido para você adicionar detalhes específicos sobre esse destino, como um endereço de e-mail ou um URL do webhook.
Opções de entrega de e-mails
Escolha E-mail na seção Para onde esses dados devem ir?. Seu conteúdo será entregue a uma lista de endereços de e-mail que você especificar.
Na seção Para quem deve ser enviado, por e-mail, digite os endereços de e-mail dos destinatários. Insira apenas 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, talvez seja possível enviar e-mails para endereços de e-mail que não estão associados a uma conta de usuário na instância do Looker. Eles são classificados como e-mails externos. Para enviar conteúdo para usuários externos, seu administrador do Looker precisa ter concedido a você permissões para entregar conteúdo para usuários externos ou ter adicionado os domínios de e-mail desses destinatários ao Permitir domínio de e-mail para conteúdo programado.
Se um destinatário for outro usuário do Looker, a opção para vincular novamente ao painel será exibida no e-mail, a menos que o administrador do Looker tenha definido a política de dados enviados por e-mail da instância do Looker como Somente dados enviados ou se a opção Incluir links estiver desmarcada.
Se todos os destinatários cancelarem a inscrição em uma entrega de e-mail programada, essa programação será excluída do Looker, mesmo das 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 de e-mails programadas.
Consulte a seção Como aplicar opções de entrega avançadas 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 em uma mensagem personalizada a 1.500.
As entregas por e-mail não podem exceder 20 MB (para formatos no corpo do e-mail) e 15 MB (para formatos entregues 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 em uma ampla variedade de aplicativos. Por exemplo, você pode programar a entrega periódica de um Look ou painel para um webhook. Quando você configurar uma entrega, o Looker solicitará o endereço do webhook.
Na seção Onde os dados devem ser enviados?, escolha Webhook. Na seção URL do webhook, insira o URL para onde a Looker deve enviar uma solicitação HTTPS para essa entrega. Você pode acessar esse URL no serviço da Web que está usando para processar o webhook. Para configurar um webhook, acesse o serviço da Web e faça o seguinte:
- Receber um URL para o qual 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 outras configurações para receber dados do Looker.
O procedimento exato varia de acordo com o serviço da Web e o aplicativo de destino usados para exibir o painel. Consulte esta postagem da Comunidade do Looker sobre Como programar aparências e painéis usando webhooks (3.46+) para ver diretrizes sobre como configurar outro aplicativo para receber os dados de webhook do Looker.
O Looker tentará enviar para um webhook por no máximo 30 minutos. O destino precisa 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 precisarão criar um bucket do S3 com a Amazon para que o Looker possa usá-lo.
Se você escolher a opção de destino do Amazon S3, o Looker solicitará configurações adicionais sobre a formatação e sobre o bucket do Amazon S3, conforme descrito nesta página. Veja esta postagem da Comunidade do Looker sobre programação (ilimitada) de resultados para S3 para mais detalhes sobre o envio 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 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 seu bucket S3, fornecido pela Amazon.
- Chave secreta: é a chave de acesso secreta do seu bucket S3, fornecida pela Amazon.
- Região: a região de serviços da Amazon em que seu bucket do S3 está hospedado.
Opções de entrega para servidores SFTP
Escolha SFTP na seção Para onde esses dados devem ir? e envie seu painel para um servidor SFTP. Enviar resultados a um servidor SFTP é um bom método a ser usado quando os dados ou a visualização são muito grandes para serem enviados por e-mail. Se você escolher essa opção de exibição, o Looker solicitará o endereço do servidor SFTP, o nome de usuário e a senha conforme descrito abaixo.
Observe o seguinte sobre as entregas de SFTP:
- Para receber entregas SFTP do Looker, verifique se o administrador da rede adicionou 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 caracteres alfanuméricos, sublinhados (_) e hifens (-) são aceitos no nome de arquivo da entrega. O Looker excluirá todos os caracteres além dos caracteres
A-Z,a-z,0-9,_ou-inseridos no campo Dê um nome à sua programação.
Quando você escolhe o SFTP, o Looker solicita o URL e as informações de login do servidor:
Endereço: o URL ou o endereço IP do servidor SFTP para onde você quer enviar os dados. Por exemplo:
sftp://files.looker.com/Marketing/In/
ousftp://192.168.0.10/Marketing/In/Este URL de exemplo termina com o caractere
/. Isso indica que o arquivo será salvo em uma pasta chamadaIn. Se você não incluir a/, o arquivo será salvo na pastaMarketinge "In" será anexado ao nome do arquivo. É preciso ter acesso de gravação à pasta em que você quer criar o arquivo.Nome de usuário e senha: credenciais de login para o servidor SFTP
Algoritmo de troca de chaves preferido: este campo é opcional. Para configurá-la, escolha o algoritmo de troca de chaves SSH que preferir. 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 levam muito tempo para gerar uma chave SSH. Essa opção permite usar um algoritmo que pode demorar menos. A escolha de um dos algoritmos o torna o algoritmo preferido para estabelecer a conexão SSH. Se o algoritmo não for compatível com o servidor, todos os outros algoritmos serão usados nas próximas tentativas. Quando ele é definido como Padrão, a ordem original dos algoritmos na biblioteca de conexão é usada.
No momento, o suporte a SFTP é limitado a credenciais de nome de usuário e senha. As credenciais da chave privada SSH não são compatíveis.
Os algoritmos da chave de host compatíveis com os envios SFTP do Looker são:
ssh-rsassh-dssssh-rsa-cert-v01@openssh.comssh-rsa-cert-v00@openssh.com
O Looker armazena impressões digitais de SFTP no seu servidor SFTP. Se você encontrar erros na entrega do SFTP, isso pode indicar que as impressões digitais do SFTP são inválidas. Nesse caso, entre em contato com o administrador do Looker.
O erro
Java::JavaLang::NullPointerExceptionspode acontecer quando você envia dados para um servidor SFTP porque um bug no JRuby 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 nos 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 de arquivo:
<name>_<timestamp>_<token>.<file extension>
- O nome informado no campo Dê um nome à sua programação depois que o Looker remove todos os caracteres além 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 de arquivo
Exemplo: Test_Schedule_2019-04-11T1130_HWkvys.csv
Opções de entrega para integrações de terceiros
O programador exibirá todas as ações que foram ativadas pelo administrador do Looker. Dependendo do serviço, pode haver campos adicionais específicos do destino. Esses campos fornecem ao serviço integrado outras informações necessárias para executar a ação selecionada com seus dados. Saiba mais sobre como enviar dados de integrações na seção Entregar dados do painel ou da consulta da página de documentação Como compartilhar dados usando um hub de ações.
Para ver uma descrição das informações exigidas por cada serviço, encontre o destino dele em uma das listas abaixo e navegue até o URL mostrado na coluna Como usar este destino.
A lista a seguir mostra todos os serviços integrados em que você pode entregar uma aparência ou os resultados de uma exploração:
Como escolher o formato dos 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 por e-mail da instância do Looker como Enviar somente link.
"Aparências" e "Explorar" apresentam diferentes opções de formatação 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 abaixo para ver uma explicação sobre como cada formato é exibido em cada destino.
| Formato | Webhook | Amazon S3 | SFTP | |
|---|---|---|---|---|
| Tabela de dados | A tabela de dados no corpo do e-mail no formato HTML | Indisponível para esse destino | Indisponível para esse destino | Indisponível para esse destino |
| Visualização | a visualização no corpo do e-mail como uma imagem PNG; | Indisponível para esse destino | Indisponível para esse destino | Indisponível para esse destino |
| CSV | A tabela de dados como um anexo de arquivo de texto separado por vírgula | A tabela de dados como um anexo de arquivo de texto separado por vírgula | A tabela de dados como um anexo de arquivo de texto separado por vírgula | A tabela de dados como um anexo de arquivo de texto separado por vírgula |
| 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 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 de um campo de 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 de um campo de 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 de um campo de dimensão ou medida como o valor renderizado em vez do rótulo do campo. |
| JSON: identificador | Indisponível para esse destino | A tabela de dados no formato JSON. Nesse formato, o Looker usa o campo labels como o valor renderizado na saída JSON. | Indisponível para esse destino | Indisponível para esse destino |
| JSON: simples, in-line | Indisponível para esse destino | A tabela de dados enviada diretamente no formato JSON. Nesse formato, o Looker usa o nome de um campo de dimensão ou medida como o valor renderizado em vez do rótulo do campo. | Indisponível para esse destino | Indisponível para esse destino |
| JSON: detalhado, in-line | Indisponível para esse destino | A tabela de dados enviada diretamente no formato JSON, com detalhes adicionais como metadados de campo, informações de cache, quando a consulta foi concluída e quanto tempo levou para ser executada. Nesse formato, o Looker usa o nome de um campo de 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, quando a consulta foi concluída e quanto tempo levou para ser executada. Nesse formato, o Looker usa o nome de um campo de 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, quando a consulta foi concluída e quanto tempo levou para ser executada. Nesse formato, o Looker usa o nome de um campo de dimensão ou medida como o valor renderizado em vez do rótulo do campo. |
| Texto | A tabela de dados como um anexo de arquivo de texto delimitado por tabulações | A tabela de dados como um anexo de arquivo de texto delimitado por tabulações | A tabela de dados como um anexo de arquivo de texto delimitado por tabulações | A tabela de dados como um anexo de arquivo de texto delimitado por tabulações |
| HTML | A tabela de dados como um anexo de arquivo HTML | A tabela de dados como um anexo de arquivo HTML | A tabela de dados como um anexo de arquivo HTML | A tabela de dados como um anexo de arquivo HTML |
Acionamento da entrega
Essa opção não estará disponível se você enviar uma análise detalhada ou enviar uma visualização única.
Ao programar entregas recorrentes, você tem duas opções para acioná-las:
- 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 nesta página.
- Atualização do grupo de dados: se o desenvolvedor do LookML tiver configurado grupos de dados, será possível programar a entrega para que ele seja acionado depois que um grupo de dados for acionado, tiver gerenciado o cache e recriado PDTs relevantes.
Como especificar o gatilho do grupo de dados
Você não verá essa opção se enviar um "Explorar", uma entrega única de uma visualização ou se tiver especificado um acionador de intervalo de repetição para a exibição recorrente.
Para usar um gatilho de 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 o 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 que estão incluídos no bloco Acesso específico ou no painel, mesmo que os grupos de dados não sejam usados para lidar com o armazenamento em cache de consultas ou PDTs.
As programações baseadas em grupos de dados só são acionadas quando o processo de regeneração é concluído para todos os PDTs que persistem nesse grupo, garantindo que a entrega inclua os dados mais atualizados.
Como especificar a recorrência da entrega
Você não verá essa opção se enviar um "Explorar", uma entrega única de uma aparência ou se tiver especificado um acionador de atualização de grupo de dados para sua exibição recorrente.
Para entregas que usam um intervalo recorrente, é possível personalizar o tempo da programação na seção Enviar esta programação. Selecione Intervalo repetido na seção Acionador do programador. As opções de tempo mudam conforme você escolhe entre Diariamente, Semanalmente, Mensalmente, 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 para os intervalos Por hora e Por minuto não é inclusivo. A última entrega será enviada no intervalo selecionado antes do horário de término especificado. Por exemplo, se o conteúdo estiver programado para A cada hora, entre 0h e 23h, ele será enviado na hora, de hora em hora, das 00h às 22h. Se o conteúdo estiver programado para Por minuto, a cada 30 minutos, entre 00h e 11h, e 11h, e 11h,
Aplicar filtros à exibição
Essa opção não estará disponível se você enviar uma exploração.
Se você estiver exibindo uma interface ou um painel que tenha filtros, poderá modificar as condições de filtro para filtrar ainda mais os resultados exibidos.
Clique em Filtros para ver e modificar os filtros associados à aparência ou ao painel para a exibição. Alterar essas opções no filtro não altera os filtros no painel ou na aparência. Se um filtro do painel requer um valor de filtro e o filtro de programação está em branco, uma programação não vai mostrar resultados após a exibição.
Se você mudar os nomes dos campos que servem como filtros nas suas aparências ou painéis, revise a seção Filtros das visualizações e painéis programados e atualize os filtros conforme necessário para refletir as alterações. Se uma exibição de conteúdo programada incluir filtros que não funcionam mais (por exemplo, se o campo referenciado tiver mudado), a exibição programada poderá expor dados não filtrados.
Para personalizar ainda mais as entregas, é possível usar a opção de filtro corresponde a um atributo de usuário se os administradores do Looker tiverem configurado valores específicos do usuário chamados atributos de 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 de entrega avançadas
A seção Opções avançadas fornece personalização adicional para sua exibição. Clique na seta ao lado de Opções avançadas para expandir esse menu. As opções disponíveis dependem do destino e do formato selecionados de envio e se você está exibindo um painel, uma aparência ou uma opção "Explorar". Os links na tabela abaixo direcionam para uma descrição de cada opção disponível para entregas de acessos ou explorações aos destinos nativos do Looker. As entregas para integrações de terceiros podem ter opções avançadas exclusivas disponíveis.
Envie esta programação se
Para entregas recorrentes de aparências, só é possível personalizar a programação de exibição do conteúdo da aparência quando determinadas condições são atendidas. Os alertas oferecem uma função semelhante para blocos de painel.
No menu suspenso Enviar esta programação se, especifique se você quer enviar o conteúdo de aparência somente se houver resultados, se não houver resultados ou se houver resultados ou nenhum resultado. Por exemplo, é possível usar filtros de usuário para criar condições para situações que você queira monitorar, como itens abaixo de uma determinada quantidade de inventário, despesas acima de um determinado valor e assim por diante, além de exibir o conteúdo somente se essa condição tiver sido alcançada.
Também é possível especificar que haverá uma exibição somente se os resultados da consulta tiverem sido alterados desde o último envio de dados, marcando a caixa ao lado de e os resultados foram alterados desde a última execução. Essa opção não estará disponível se você quiser usar a opção de limite Todos os resultados.
Limite
É possível limitar o tamanho da sua entrega selecionando uma das seguintes opções de limite para seus dados:
- Resultados na tabela:os dados são enviados como uma única entrega.
- Todos os resultados:os dados são transmitidos (veja mais em Quais são os limites de linha no Looker? página de práticas recomendadas). Isso é útil para grandes conjuntos de dados, já que eles ignoram limitações de tamanho de arquivo, navegador e memória.
Se você escolher Resultados na tabela, o Looker seguirá as limitações de linha que você tiver configurado no recurso Aparência salvo ou Explorar. Se você escolher Todos os resultados, o Looker retornará todas as linhas da consulta, independentemente das configurações do Look salvo e do limite típico de 5.000 linhas do Looker. Isso pode ser desejável para recuperar conjuntos de dados muito grandes, mas você deve ter cuidado para garantir que a consulta não seja muito grande para o seu banco de dados.
Limitar as opções para e-mails
Ao enviar "Aparências e explosões", você pode limitar o tamanho das mensagens para não ultrapassar o limite de tamanho das mensagens 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 os e-mails que usam as opções de formato da Tabela de dados ou da Visualização. E-mails com mais de 5.000 linhas não serão enviados.
- Todos os resultados: se você estiver usando as opções de formato Texto, CSV, JSON — Simples, XLSX ou HTML, poderá enviar todas as linhas dos resultados de uma aparência salva. Essa opção ignora os limites definidos em um recurso "Look" salvo ou no limite típico de 5.000 linhas do Looker. Há um limite de dados de 15 MB para que os aplicativos de e-mail aceitem o anexo. E-mails com mais de 15 MB com anexo não serão enviados. Se você especificar um formato de tabela de dados ou de visualização e selecionar Todos os resultados, o Looker mudará automaticamente o formato para usar um anexo de texto e permitir o envio de todos os resultados.
Para verificar se você está dentro do limite de dados ou linhas dos e-mails programados, insira seu próprio endereço de e-mail como destinatário e clique em Enviar teste para enviar os dados para você imediatamente. Se você não receber o e-mail, provavelmente atingiu o limite de linhas ou de dados.
Opções de e-mail
As entregas por e-mail têm opções adicionais, conforme descrito abaixo.
Executar programação como destinatário
Essa opção está disponível apenas para o destino de e-mail.
A opção Executar programação como destinatário permite que os administradores especifiquem uma lista de usuários que receberão a entrega de conteúdo como se eles tivessem executado a consulta com base nas permissões. Os usuários que não são administradores também podem inserir o próprio endereço de e-mail para receber uma entrega como se tivessem consultado o conteúdo com base nas permissões. Isso significa que os filtros de acesso e os atributos de usuário de cada usuário serão aplicados aos dados incluídos em cada e-mail.
Por exemplo, digamos que um administrador do Looker precise programar o relatório a seguir para uma série de usuários e cada usuário tenha 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 seguintes resultados filtrados ao usuário A:
Essa opção leva em conta as permissões do usuário que cria a programação, bem como os tipos de endereços de e-mail adicionados ao campo de texto Para quem deve ser enviado 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 diferente
- 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 da opção Executar programação como destinatário ser selecionada, a opção será desativada automaticamente. Ele fica disponível novamente quando o endereço de e-mail é excluído da lista de destinatários.
- Se o endereço de e-mail tiver sido adicionado depois que a opção Executar programação como destinatário for selecionada, adicionar o endereço de e-mail produzirá um erro e o e-mail será removido automaticamente do campo Para quem deve ser enviado por e-mail?. A opção Executar programação como destinatário permanecerá 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 desse usuário está desativada, a programação não é entregue ao usuário desativado a partir da próxima vez que é executada. Se a conta desse usuário for excluída, a programação inteira não será entregue a nenhum destinatário. Um administrador ou usuário do Looker com a permissão see_schedules 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 instância do Looker como Enviar links e dados, o programador exibirá uma opção para Incluir vinculações. Quando essa opção está marcada, as entregas de dados de e-mail incluem um link de volta para o Looker: "Ver relatório completo" para visualizações e explorações entregues e "Ver painel completo" para painéis entregues.
Essa vinculação permite que os destinatários dos e-mails explorem ainda mais os dados na sua instância do Looker. Os destinatários precisam fazer login no Looker e ter permissões para acessar o modelo no qual o conteúdo enviado se baseia para visualizar esse conteúdo no Looker. Se você quiser remover esse link dos e-mails de entrega de dados, desmarque a caixa de seleção Incluir links.
Opções de formatação
As entregas que não usam o formato de visualização têm opções adicionais, conforme descrito abaixo.
Aplicar opções de visualização
Essa opção não está disponível para entregas do tipo "Olhar" ou "Explorar" no formato de visualização.
Selecione Aplicar opções de visualização para que seus dados sejam exibidos em um gráfico de tabelas. Qualquer uma das seguintes configurações nos menus Plotar, Série e Formatação definidas para a visualização será aplicada:
- Mostrar números das linhas
- Ocultar totais
- Ocultar totais da linha
- Limitar linhas exibidas a, no máximo, 500 linhas mostradas ou ocultas.
- Mostrar nome do campo completo
- Rótulos personalizados para cada coluna (o formato JSON — Detail, Inline sempre usa nomes de campo brutos, não o rótulo de campo. Consulte a postagem da comunidade Mudança na formatação JSON para mais informações sobre como o Looker renderiza campos no formato JSON).
- Formatação condicional para entregas de visualizações de gráficos de tabelas no formato Excel
A formatação condicional só será exibida nas entregas do Excel com "Looks and Explores" com visualizações de gráfico de tabela se a regra Ao longo de uma escala for aplicada.
Desmarque Aplicar opções de visualização para o Looker enviar os dados como aparecem na seção Dados da janela "Visualizar" ou um bloco do painel Explorar a partir daqui. JSON: o campo usa o campo label, mesmo que a opção Aplicar opções de visualização esteja desmarcada.
Valores de dados formatados
Essa opção não está disponível para entregas do tipo "Olhar" ou "Explorar" no formato de visualização.
É possível configurar a formatação dos dados:
- Selecione Valores de dados formatados para mostrar os dados de forma mais semelhante à experiência de exploração no Looker. No entanto, alguns recursos (como a vinculação) não são compatíveis com todos os tipos de arquivo.
- Desmarque Valores de dados formatados se não quiser aplicar nenhuma formatação especial dos 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, você pode personalizar a largura da visualização usando o menu suspenso Resolução da tabela. As opções de largura são as seguintes:
- Normal: 800 pixels
- Amplo: 1.680 pixels
Se você escolher Amplo e a largura da visualização exceder o limite definido pelo cliente de e-mail, talvez os destinatários da entrega de e-mail precisem rolar horizontalmente para ver toda a visualização.
Fuso horário
Por padrão, o Looker usa o fuso horário associado à sua conta para determinar quando enviar a entrega de dados. Se você não tiver um fuso horário associado à sua conta, o Looker 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 seu painel ou aparência, apenas o tempo de exibição.
Como testar a exibição
Clique no botão Enviar teste para enviar uma entrega de teste única ao destino especificado.
Salvando a entrega
Um resumo das configurações de exibição será exibido na parte inferior do programador.
Para entregas únicas, quando 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 terminar de configurar as opções de entrega, clique no botão Salvar todas para salvar a programação e fechar a janela. O conteúdo será exibido de acordo com suas configurações de envio. 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. Para isso, clique no ícone Duplicar ou Excluir, respectivamente.
A programação salva também aparecerá na página Programações que você criou no seu perfil de usuário e nas páginas Programações e Histórico de programações no painel Administrador. Consulte a seção Como exibir entregas nesta página para mais informações.
Como ver entregas
Você pode ver as programações que criou e, com as permissões adequadas, todas as programações para a instância do Looker.
Como ver as entregas que você criou
Para ver uma lista de todas as programações criadas, acesse a página Programações que você criou. Para acessá-las, clique no ícone do seu perfil de usuário e selecione Programações. Consulte a página Como ver suas entregas de dados programadas para saber como ver e gerenciar as programações que você criou.
Ver entregas criadas por outros usuários
Se o administrador do Looker tiver concedido permissões para ver as páginas de administrador das Programações e do Histórico de programações, você verá a lista de todas as programações de toda a instância do Looker. No entanto, você não poderá editar ou excluir essas programações.
Informações úteis
Às vezes, uma entrega programada de e-mail pode não alcançar um ou mais destinatários. Isso poderá acontecer se o modelo subjacente tiver um erro, se o destinatário não tiver acesso aos dados ou se houver problemas de renderização ou erros de página.
Outros desafios podem surgir:
- Caso sua empresa tenha definido as próprias configurações de e-mail na seção Administrador do Looker, os administradores do Looker precisarão verificar se as configurações estão corretas e se seu provedor de e-mail está funcionando corretamente.
- Dependendo da configuração do Limite, a entrega de dados será limitada a 5.000 linhas ou a um tamanho máximo de arquivo de 15 MB para e-mails com anexos e 20 MB para e-mails com conteúdo inline. E-mails com mais linhas ou dados que esses limites não serão enviados.
- Se um e-mail não for enviado no horário esperado, mas for recebido, é provável que você esteja concorrendo com outras tarefas do Looker. Essas tarefas podem incluir outros e-mails programados, várias pessoas explorando dados ao mesmo tempo ou tabelas derivadas permanentes criadas. Se isso acontecer, consulte seus administradores do Looker sobre tarefas concorrentes.
- Se um e-mail específico continuar desaparecendo da sua lista de distribuição, é provável que um usuário tenha cancelado a inscrição nesse e-mail programado. Isso pode ser muito desafiador se você usar um alias de e-mail de grupo para enviar para várias pessoas, porque qualquer destinatário pode cancelar a inscrição de todo o alias de e-mail. Se você precisa entender como funcionam as cancelamentos de inscrição, confira esta postagem da Comunidade do Looker sobre eventos de cancelamento de inscrição de um programador.