Agendar uma consulta

Você pode usar execuções de consultas agendadas para atualizar seus painéis ou habilitar alertas de rotina. Por padrão, suas consultas não têm um agendamento.

Observação

Se um alerta usar sua consulta, o alerta será executado em seu próprio agendamento de atualização e não usará o agendamento da consulta.

Para definir o agendamento:

1. No Editor de Consultas, clique em Agendamento>Adicionar agendamento para abrir um menu com agendamentos.

   

2. Escolha quando executar a consulta.

   • Use os seletores da lista suspensa para especificar a frequência, o período, a hora de início e o fuso horário. Opcionalmente, marque a caixa de seleção Mostrar sintaxe cron para editar o agendamento na Sintaxe Quartz Cron.
   • Escolha Mais opções para mostrar as configurações opcionais. Você também pode escolher:
     • Um nome para o agendamento.
     • Um SQL warehouse para potencializar a consulta. Por padrão, o SQL warehouse usado para execução de consulta ad hoc também é usado para um trabalho agendado. Use essa configuração opcional para selecionar um warehouse diferente para executar a consulta agendada.

3. Clique em Criar. Sua consulta será executada automaticamente de acordo com o agendamento. Se uma consulta agendada não for executada de acordo com o agendamento, dispare manualmente a consulta para garantir que ela não falhe.

   Se a execução de uma consulta falhar durante uma execução agendada, o Azure Databricks tentará novamente com um algoritmo de retirada. Isso significa que as repetições ocorrem com menos frequência à medida que as falhas persistem. Com falhas persistentes, a próxima repetição pode exceder o intervalo agendado.

   Após a criação de um agendamento, o rótulo do botão Agendamento fará a leitura do Agendamento(#), em que # é o número de eventos agendados que estão visíveis para você. Não é possível ver os agendamentos que não tenham sido compartilhados com você.

   Importante

   Novos agendamentos não são compartilhados automaticamente com outros usuários, mesmo que esses usuários tenham acesso à consulta. Para tornar as execuções agendadas e os resultados visíveis para outros usuários, use as configurações de compartilhamento descritas na próxima etapa.

4. Compartilhar o agendamento

   As permissões de consulta não estão vinculadas às permissões de agendamento. Após a criação do intervalo de execução agendado, edite as permissões do agendamento para fornecer acesso a outros usuários.

   • Clique em Agendamento(#).
   • Clique no menu kebab e selecione Editar permissões de agendamento.
   • Escolha um usuário ou grupo no menu suspenso da caixa de diálogo.
   • Escolha PODE EXIBIR para permitir que os usuários selecionados visualizem os resultados das execuções agendadas.

Comportamento de atualização e contexto de execução

Quando uma consulta é “Executar como proprietário” e um agendamento é adicionado, a credencial do proprietário da consulta é usada para execução, e qualquer pessoa com pelo menos CAN RUN vê os resultados dessas consultas atualizadas.

Quando uma consulta é "Executada como visualizador" e um agendamento é adicionado, a credencial do proprietário do agendamento é usada para execução. Somente os usuários com as permissões de agendamento apropriadas veem os resultados das consultas atualizadas; todos os outros visualizadores devem atualizar tudo manualmente para ver os resultados atualizados das consultas.