Agendar uma função de dados do utilizador

O agendador de trabalhos no Microsoft Fabric permite-lhe executar funções de dados de utilizador (UDFs) num calendário recorrente sem necessidade de pipeline, notebook ou serviço de orquestração externo. Pode configurar agendamentos diretamente numa função de dados do utilizador, especificar padrões de recorrência, passar parâmetros de função e monitorizar execuções a partir da experiência de monitorização do Fabric.

Pré-requisitos

Antes de criar um horário, certifique-se de que:

• Tem uma função de dados de utilizador publicados.
• Tens permissões de Colaborador ou superior no espaço de trabalho.
• A função é testada com sucesso através da invocação manual.
• Configuras todas as ligações, segredos ou dependências necessárias.

Casos de uso

Programe funções de dados dos utilizadores para automatizar tarefas empresariais e operacionais recorrentes. Cenários comuns incluem:

• Validação da qualidade dos dados – Realizar verificações nos conjuntos de dados antes de reportar ou processar a jusante.
• Processamento de feedback dos clientes – Analise novos feedbacks, gere pontuações de sentimento e armazene resultados.
• Geração de eventos empresariais – Detetar alterações nos dados operacionais e publicar eventos empresariais para aplicações a jusante.
• Limpeza programada – Arquivar registos antigos, remover ficheiros temporários ou realizar tarefas de manutenção rotineiras.
• Sincronização periódica de dados – Sincronizar dados de sistemas externos para o Fabric num calendário recorrente.
• Notificações automáticas – Gerar alertas ou notificações com base em regras de negócio e limiares.

Abre o agendador

1. Abra o espaço de trabalho do Fabric.
2. Abra o item da função de dados do utilizador.
3. Selecione Definições.
4. Selecione Agendar.

A página de Agendamento permite-lhe:

• Criar horários
• Configurar notificações de falha
• Ver execuções agendadas
• Editar ou desativar horários
• Executar manualmente trabalhos agendados

Criar uma agenda

1. No Agendamento, selecione Adicionar horário.

2. Configura as propriedades do agendamento.

   O agendador suporta as seguintes definições:

   Setting	Description
   Controller	Variável usada para controlar a execução a partir da biblioteca de variáveis
   Repetir	Define o padrão de recorrência
   Intervalo	Intervalo de frequência
   Data e hora de início	Quando o calendário começa
   Data e hora de fim	Quando o calendário expira
   Fuso horário	Fuso horário para execução do cronograma
   Parameters	Parâmetros de entrada passados para a função

   Selecione com que frequência a função deve ser executada e forneça os detalhes do agendamento. O agendador suporta execuções recorrentes, como a cada poucos minutos, a cada hora, diariamente, semanalmente ou mensalmente. Por exemplo, para executar uma função a cada 15 minutos, configure:

3. Fornecer o parâmetro para FunctionName. Este parâmetro é necessário para definir a função que está a chamar.

   Nome do parâmetro	Tipo	Valor
   Nome da função	String	Nome das funções, por exemplo hello_fabric.

4. Adicione mais parâmetros para as entradas da função. Por exemplo, para hello_fabric(name:str), adicione um parâmetro name do tipo string.

   Nome do parâmetro	Tipo
   Nome	String

   Importante

   Os nomes dos parâmetros devem corresponder exatamente à assinatura da função de dados do utilizador. Os nomes dos parâmetros são sensíveis a maiúsculas e minúsculas.

5. Guarda o horário.

6. Adiciona mais horários para outras funções no item da tua função de dados de utilizador.

Executar manualmente uma função agendada

Para testar uma função agendada imediatamente, selecione Executar. Fabric submete uma execução sem esperar pelo próximo intervalo programado. A execução manual é útil para validar parâmetros, verificar ligações e testar a lógica das funções.

Monitorizar execuções agendadas

Pode monitorizar as execuções das funções de dados do utilizador a partir da experiência de monitorização do Fabric.

1. Abra Monitor Hub.
2. Selecione Atividades.
3. Filtrar por funções de dados do utilizador.

Use a experiência de monitorização para diagnosticar execuções falhadas e validar execuções bem-sucedidas.

Configurar notificações de falha

Pode configurar notificações por email para execuções agendadas falhadas.

1. Abra a página de Horários .
2. Nas notificações de falha, introduza um ou mais endereços de email.
3. Salve a configuração.

O Fabric envia notificações por email sempre que uma execução agendada falha.

Passos seguintes

• Aprenda sobre as funções de dados do utilizador.
• Saiba mais sobre o agendador de tarefas na Fabric.
• Monitorizar e diagnosticar cargas de trabalho do Fabric usando o hub Monitor.