Gerenciar atualizações e assinaturas agendadas do painel

Agendar atualizações de painéis garante que seus painéis exibam informações de up-todata e melhore o desempenho para os usuários finais. As subscrições mantêm as partes interessadas informadas enviando snapshots do painel para email, Slack ou Microsoft Teams. Esta página explica como configurar e gerir subscrições.

Criar uma agenda

Ao criar uma agenda para atualizações de painel, você define uma cadência periódica que extrai os dados mais recentes e, para painéis publicados com permissões de dados compartilhados, atualiza o cache compartilhado.

Para cada atualização agendada do painel, ocorre o seguinte:

• Toda a lógica SQL que define conjuntos de dados é executada no intervalo de tempo designado.
• Os resultados preenchem o cache de resultados da consulta e ajudam a melhorar o tempo de carregamento inicial do painel.

Benefícios das permissões de dados compartilhados para atualizações agendadas

Os painéis publicados com permissões de dados compartilhados oferecem melhor desempenho e eficiência de cache em comparação com permissões de dados individuais:

• Cache compartilhado: As atualizações agendadas preenchem um cache de resultados de consulta compartilhado que todos os visualizadores do painel podem acessar, melhorando significativamente os tempos de carregamento para todos os usuários.
• Atualização de cache individual: Mesmo quando um painel é publicado com permissões de dados individuais, os usuários podem assinar agendas para acionar atualizações de cache. Isso garante que o seu cache pessoal permaneça atualizado e reduz os tempos de carregamento quando acessam o painel.
• Carga de consulta reduzida: Como os resultados são armazenados em cache e compartilhados, as consultas SQL subjacentes são executadas com menos frequência, reduzindo os custos de computação e a carga do depósito.

Os utilizadores que subscrevem a uma agenda beneficiam destas atualizações de cache, mesmo que não precisem da captura PDF do e-mail. A assinatura inicia o fluxo de trabalho de atualização do cache, garantindo que o painel seja carregado rapidamente quando eles o visitam.

Para criar uma agenda:

1. Clique em Agendar no canto superior direito do painel. A caixa de diálogo Adicionar agenda é exibida.

   

2. Insira um identificador de nome para sua nova agenda.

3. Use os seletores suspensos para especificar a frequência e a hora de início, se necessário. Opcionalmente, marque a caixa de seleção Mostrar sintaxe cron para editar a agenda em Quartz Cron Syntax.

4. Use o menu suspenso Fuso horário para selecionar o fuso horário.

5. Escolha Usar valores padrão ou Usar seleções de filtro para determinar quais valores de filtro são aplicados no painel durante uma execução agendada.

   • Usar valores padrão: Aplica os valores padrão dos widgets de filtro do painel de controlo.
   • Use seleções de filtro: Aplica os valores de filtro definidos quando a agenda é criada.

6. Use o menu suspenso SQL warehouse para escolher um SQL warehouse diferente para execuções agendadas. Por padrão, o SQL warehouse usado para criar e executar o painel também é usado na execução agendada. Use essa configuração para escolher um depósito diferente para executar atualizações agendadas.

7. (Opcional) Clique em Subscritores para adicionar subscritores. Os utilizadores recebem um e-mail com um instantâneo em PDF do painel depois de concluída uma tarefa agendada.

8. Clique em Criar. A caixa de diálogo Agendas é exibida e mostra a agenda que você criou. Se existirem outras agendas para este painel, a caixa de diálogo também as mostrará.

Se já tiver sido criada uma agenda para este dashboard, o botão no canto superior direito indica Subscrever. Use o fluxo de trabalho descrito anteriormente para adicionar uma agenda.

Gerenciar agendas

Para editar, pausar ou excluir uma agenda:

1. Clique em Agendar no painel publicado. É apresentada uma lista de agendas para o dashboard.
2. Clique no à direita da agenda que queres gerir.
3. Clique em Editar, Pausar ou Excluir.

• Editar: Abre a interface de agendamento. Use a interface do usuário para ajustar o agendamento e, em seguida, salve.
• Pausar ou Retomar: define se a agenda está ativa ou pausada. As agendas pausadas mantêm suas configurações e configurações de assinante, mas o painel não atualiza nem envia notificações até que a agenda seja retomada.
• Suprimir. Remove a programação e todas as configurações do assinante.

Gerir subscrições

Os assinantes do Schedule recebem um instantâneo do painel atual sempre que a agenda é executada. Os subscritores recebem snapshots do painel através de email, Slack ou Microsoft Teams. Os subscritores de e-mail recebem uma imagem em PDF. Os canais do Slack e do Microsoft Teams recebem um instantâneo de imagem PNG visível diretamente no canal, um link direto para abrir o painel no Azure Databricks e um anexo PDF no tópico de mensagens. Para painéis com várias páginas, o instantâneo mostra a primeira página do painel.

Para painéis publicados com permissões de dados compartilhados, a assinatura de uma agenda também aciona atualizações de cache que melhoram os tempos de carregamento do painel. Os usuários podem se inscrever mesmo que não precisem de notificações por e-mail, beneficiando de um desempenho mais rápido quando acessam o painel.

Destinos de subscrição

As subscrições do painel suportam os seguintes destinos:

• E-mail: os utilizadores do espaço de trabalho e os destinatários das notificações por e-mail recebem uma imagem instantânea em PDF por e-mail. Você pode configurar usuários de conta, listas de distribuição e usuários externos (como parceiros ou clientes) como destinos de notificação por email.
• Slack: os canais do Slack recebem um instantâneo de imagem PNG visível diretamente no canal, um link direto para abrir o painel no Azure Databricks e um anexo PDF no histórico de mensagens. Os administradores do espaço de trabalho devem configurar os destinos de notificação do Slack antes que você possa selecioná-los como assinantes. Consulte Configurar notificações do Slack.
• Microsoft Teams: Os canais do Teams recebem um snapshot de imagem PNG visível diretamente no canal, um link direto para abrir o dashboard no Azure Databricks e um anexo PDF no tópico de mensagens. Os administradores do espaço de trabalho devem configurar os destinos de notificação do Microsoft Teams antes de os poder selecionar como subscritores. Consulte Configurar notificações do Microsoft Teams.

Os administradores do espaço de trabalho devem definir destinos de notificação antes de poderem ser selecionados como assinantes. Veja como gerir destinos de notificação em destinos de email, como configurar notificações Slack em destinos Slack e como configurar notificações Microsoft Teams em destinos Microsoft Teams.

Você pode adicionar e remover outros assinantes para receber atualizações se tiver pelo menos permissões CAN EDIT no painel. Você pode adicionar e remover a si mesmo como assinante de uma agenda existente se tiver pelo menos permissões CAN VIEW no painel.

Subscreva um canal Slack ou Microsoft Teams

Antes de poder subscrever os canais do Slack ou do Microsoft Teams, os administradores do espaço de trabalho têm de configurar os destinos das notificações. Veja Configurar notificações do Slack para destinos do Slack e Configurar notificações do Microsoft Teams para destinos do Microsoft Teams.

Para subscrever um canal Slack ou Teams:

1. Clique em Agendar no canto superior direito do painel.
2. Crie uma nova agenda ou edite uma agenda existente:
   • Para criar uma nova agenda, insira o nome da agenda, a frequência e os valores de filtro e clique em Criar.
   • Para editar uma agenda existente, clique no ao lado da agenda e selecione Editar.
3. Na configuração de agendamento, clique em Assinantes.
4. Escreva para procurar e selecione o destino da notificação.
5. Clique em Salvar.

Quando o calendário termina, uma notificação é publicada no canal Slack ou Teams configurado.

Se encontrar problemas, consulte Resolução de Problemas ou Slack e Resolução de Problemas para Microsoft Teams.

Subscreva outros utilizadores

Para inscrever outros usuários, faça o seguinte:

1. Clique em Subscrever no canto superior direito do dashboard. A caixa de diálogo Agendas é exibida.
2. Identifique a agenda à qual pretende adicionar subscritores. Clique no à direita do horário. Em seguida, clique em Editar.

Se você tiver acesso CAN VIEW a um painel que tenha uma agenda atribuída, poderá se inscrever para receber atualizações sempre que ocorrer uma execução agendada.

Para se inscrever em uma agenda existente, faça o seguinte:

1. Clique no botão Inscrever-se perto do canto superior direito do painel. A caixa de diálogo Agendas mostra todas as agendas do painel.
2. Clique em Subscrever à direita do horário que escolher.

Se não conseguir adicionar-se como subscritor, poderão aplicar-se os seguintes motivos:

• Um administrador de espaço de trabalho desativou a opção Habilitar assinaturas do painel para o espaço de trabalho.

  Esta configuração substitui todas as outras. Se o administrador do espaço de trabalho tiver desativado essa configuração, os editores do painel ainda poderão atribuir uma agenda, mas nenhum assinante poderá ser atribuído.

• Você não tem permissão para acessar o espaço de trabalho.

  Os usuários da conta só podem ser adicionados como assinantes como um destino de notificação. Não há nenhum botão Inscrever-se no painel para usuários da conta.

• Não foram definidos horários.

  Para painéis sem uma agenda definida, os utilizadores do espaço de trabalho com acesso "CAN VIEW" ou "CAN RUN" a um dashboard não podem interagir com o botão Subscrever.

Cancelar inscrição de atualizações por e-mail

Os subscritores podem optar por deixar de receber notificações cancelando a subscrição da programação.

• Para cancelar a inscrição usando a interface do usuário do painel, faça o seguinte:

  1. Clique no botão Inscrever-se perto do canto superior direito do painel. A caixa de diálogo Agendas mostra todas as agendas do painel.
  2. Clique em Inscritos para cancelar a inscrição. O texto do botão muda para Subscrever.

  

• Use o link Cancelar inscrição no rodapé do e-mail para cancelar a assinatura de atualizações agendadas.

Limites de tamanho do painel para assinaturas

Os e-mails de assinatura do painel incluem os seguintes arquivos codificados base64:

• PDF: Um arquivo PDF que inclui o painel completo.
• DesktopImage: Um arquivo de imagem otimizado para visualização em computadores desktop.

Para obter informações sobre os limites de tamanho da assinatura do painel e o comportamento quando os limites são excedidos, consulte Limites de assinatura do painel.

Segurança de dados para anexos PDF

Quando um PDF de painel é gerado para entrega ou download agendado, ele é armazenado temporariamente no armazenamento em nuvem configurado por um administrador de espaço de trabalho durante a criação do espaço de trabalho. Esse armazenamento é gerenciado pelo Azure Databricks e não é diretamente acessível externamente. Saber onde os PDFs residem e como eles são excluídos pode ajudá-lo a atender aos requisitos de segurança e conformidade. Consulte Implantar um espaço de trabalho usando o Portal do Azure.

Política de eliminação de PDF

Atualizações agendadas (assinaturas de e-mail): Após a conclusão do processo de e-mail, o PDF é imediatamente excluído do armazenamento de objetos.

Downloads iniciados pelo usuário: Quando um usuário baixa manualmente um PDF do painel da interface do usuário, o arquivo permanece temporariamente no armazenamento de objetos por até 60 dias. Esse período de retenção permite tempo para a conclusão do download, solução de problemas ou novos downloads, se necessário.