Gerenciar atualizações e assinaturas agendadas do painel

Agendar atualizações do painel garante que seus painéis exibam informações de data up-toe melhorem o desempenho dos usuários finais. As assinaturas mantêm as partes interessadas informadas enviando instantâneos dos dashboards para o email, Slack ou Microsoft Teams. Esta página explica como configurar e gerenciar assinaturas.

Criar um agendamento

Ao criar um agendamento 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 compartilhadas, atualiza o cache compartilhado.

Para cada atualização de painel agendada, 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 carga 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 fornecem 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 compartilhada que todos os visualizadores de dashboard podem acessar, melhorando significativamente os tempos de carga 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 disparar atualizações de cache. Isso garante que o cache pessoal permaneça atualizado e reduz os tempos de carregamento quando eles 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 armazém.

Os usuários que estão inscritos em um agendamento se beneficiam dessas atualizações de cache, mesmo que não precisem do instantâneo de PDF por email. A assinatura inicia o fluxo de trabalho de atualização de cache, garantindo que o painel seja carregado rapidamente quando eles o visitarem.

Para criar uma agenda:

1. Clique em Agendar no canto superior direito do painel. A caixa de diálogo Adicionar agendamento é 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 o agendamento na Sintaxe Quartz Cron.

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.

   • Use valores padrão: Aplica os valores padrão dos widgets de filtro do painel.
   • Use seleções de filtro: Aplica os valores de filtro definidos quando o agendamento é criado.

6. Use o menu suspenso do 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 warehouse diferente para executar atualizações agendadas.

7. (Opcional) Clique em Assinantes para adicionar assinantes. Os assinantes recebem um email com um instantâneo em PDF do painel após a conclusão de uma tarefa agendada.

8. Clique em Criar. A caixa de diálogo Agendamentos é exibida e mostra o agendamento que você criou. Se houver outros agendamentos para este painel, a caixa de diálogo também mostrará isso.

Se um agendamento já tiver sido criado para este painel, o botão no canto superior direito indicará Assinar. Use o fluxo de trabalho descrito anteriormente para adicionar uma agenda.

Gerenciar agendamentos

Para editar, pausar ou excluir um agendamento:

1. Clique em Agendar no painel publicado. Uma lista de agendas para o painel é exibida.
2. Clique no menu Kebab à direita da agenda que você quer gerenciar.
3. Clique em Editar, Pausar ou Excluir.

• Editar: Abre a interface de agendamento. Use a interface do usuário para ajustar o agendamento e salvar.
• Pausar ou Retomar: define se a agenda está ativa ou pausada. Os agendamentos pausados mantêm suas configurações e configurações de assinante, mas o painel não atualiza nem envia notificações até que o agendamento seja retomado.
• Excluir: Remove a agenda e todas as configurações do assinante.

Gerenciar Assinaturas

Os assinantes de agendamento recebem um instantâneo do painel atual sempre que o agendamento é executado. Os assinantes recebem instantâneos do painel por email, Slack ou Microsoft Teams. Os assinantes de email recebem um instantâneo em PDF. Os canais Slack e 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 thread da mensagem. 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 compartilhadas, a assinatura de um agendamento também dispara atualizações de cache que melhoram os tempos de carga do painel. Os usuários podem assinar mesmo que não precisem de notificações por email, beneficiando-se de um desempenho mais rápido quando acessam o painel.

Destinos de assinatura

As assinaturas do painel de controle suportam os seguintes destinos:

• Email: usuários do workspace e destinos de notificação por email recebem um instantâneo em PDF por email. 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 thread de mensagem. Os administradores do workspace devem configurar os destinos de notificação do Slack para que você possa selecioná-los como assinantes. Consulte Configurar notificações do Slack.
• Microsoft Teams: os canais do 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 thread da mensagem. Os administradores do workspace devem configurar os destinos de notificação do Microsoft Teams para que você possa selecioná-los como assinantes. Consulte Configurar notificações do Microsoft Teams.

Os administradores do workspace devem definir destinos de notificação antes de serem selecionados como assinantes. Consulte Gerenciar destinos de notificação para destinos de email, configurar notificações do Slack para destinos do Slack e configurar notificações do Microsoft Teams para destinos do 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 se adicionar ou se remover do grupo de assinantes de um agendamento existente se tiver pelo menos permissões de visualização no painel.

Assinar um canal do Slack ou do Microsoft Teams

Antes de assinar canais do Slack ou do Microsoft Teams, os administradores do workspace devem configurar destinos de notificação. Consulte Configurar notificações do Slack para destinos do Slack e configurar notificações do Microsoft Teams para destinos do Microsoft Teams.

Para assinar um canal do Slack ou do Teams:

1. Clique em Agendar no canto superior direito do painel.
2. Crie um novo agendamento ou edite um agendamento existente:
   • Para criar um novo agendamento, 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. Digite para pesquisar e selecione o destino da notificação.
5. Clique em Salvar.

Quando o agendamento é executado, uma notificação é postada no canal configurado do Slack ou do Teams.

Se você encontrar problemas, consulte solução de problemas ou Slack e solução de problemas para o Microsoft Teams.

Inscrever outros usuários

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

1. Clique em Assinar no canto superior direito do painel. A caixa de diálogo Agendamentos é exibida.
2. Identifique a agenda à qual você deseja adicionar assinantes. Clique em à direita desse agendamento. Em seguida, clique em Editar.

Se você tiver ACESSO AO MODO DE EXIBIÇÃO a um painel que tenha uma agenda atribuída, você poderá se inscrever para receber atualizações sempre que ocorrer uma execução agendada.

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

1. Clique no botão Assinar próximo ao canto superior direito do painel. A caixa de diálogo Agendamentos mostra todos os agendamentos para o painel.
2. Clique em Assinar à direita do agendamento escolhido.

Se você não puder se adicionar como assinante, os seguintes motivos podem ser aplicados:

• Um administrador do workspace desativou a opção Habilitar assinaturas do painel no workspace.

  Esta configuração substitui todas as outras. Se o administrador do workspace tiver desativado esta configuração, os editores de painel ainda poderão atribuir um agendamento, mas nenhum assinante poderá ser atribuído.

• Você não tem permissão para acessar o workspace.

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

• Nenhum agendamento foi definido.

  Para dashboards sem um agendamento definido, os usuários da área de trabalho com PERMISSÃO PARA VISUALIZAR ou PERMISSÃO PARA EXECUTAR em um dashboard não podem interagir com o botão Assinar.

Cancelar assinatura de atualizações de email

Os assinantes podem optar por parar de receber notificações ao cancelar a assinatura do agendamento.

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

  1. Clique no botão Assinar próximo ao canto superior direito do painel. A caixa de diálogo Agendamentos mostra todos os agendamentos para o painel.
  2. Clique em Inscrito para cancelar a assinatura. O texto do botão é alterado para Assinar.

  

• Use o link Cancelar assinatura no rodapé de email para cancelar a assinatura de atualizações agendadas.

Limites de tamanho do painel para assinaturas

Os emails de assinatura do painel incluem os seguintes arquivos codificados em 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 forem excedidos, consulte os limites de assinatura do Painel.

Segurança de dados para anexos PDF

Quando um PDF do painel é gerado para entrega agendada ou download, ele é armazenado temporariamente no armazenamento em nuvem configurado por um administrador do workspace durante a criação do workspace. Esse armazenamento é gerenciado pelo Azure Databricks e não está 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 workspace usando o Portal do Azure.

Política de exclusão de PDF

Atualizações agendadas (assinaturas de email): Depois que o processo de email for concluído, o PDF será 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 conclusão do download, solução de problemas ou downloads novamente, se necessário.