Agendar uma função de dados do usuário

O agendador de tarefas no Microsoft Fabric permite que você execute funções de dados do usuário (UDFs) em um cronograma recorrente sem precisar de pipeline, notebook ou serviço externo de orquestração. Você pode configurar agendamentos diretamente em uma função de dados do usuário, especificar padrões de recorrência, passar parâmetros de função e monitorar execuções a partir da experiência de monitoramento do Fabric.

Pré-requisitos

Antes de criar um cronograma, certifique-se de que:

  • Você tem uma função de dados de usuário publicados.
  • Você tem permissões de Contribuidor ou superiores no espaço de trabalho.
  • A função é testada com sucesso usando invocação manual.
  • Você configura todas as conexões, segredos ou dependências necessárias.

Casos de uso

Programe funções de dados do usuário para automatizar tarefas recorrentes de negócios e operações. Cenários comuns incluem:

  • Validação da qualidade dos dados – Realize verificações em conjuntos de dados antes de relatórios ou processamento a jusante.
  • Processamento de feedback do cliente – Analise novos feedbacks, gere scores de sentimento e armazene resultados.
  • Geração de eventos empresariais – Detectar mudanças em dados operacionais e publicar eventos de negócios para aplicações posteriores.
  • Limpeza agendada – Arquivar registros antigos, remover arquivos temporários ou realizar tarefas de manutenção rotineira.
  • Sincronização periódica de dados – Sincronizar dados de sistemas externos para o Fabric em um cronograma recorrente.
  • Notificações automatizadas – Gerar alertas ou notificações baseadas em regras de negócio e limiares.

Abra o agendador

  1. Abra o espaço de trabalho do Fabric.
  2. Abra o item da função de dados do usuário.
  3. Selecione Configurações.
  4. Selecione Agendar.

A página Agendamento permite que você:

  • Criar cronogramas
  • Configurar notificações de falha
  • Veja execuções programadas
  • Editar ou desativar os cronogramas
  • Executar manualmente trabalhos agendados

Criar um agendamento

  1. Em Agendamento, selecione Adicionar agendamento.

  2. Configure as propriedades do cronograma.

    O escalonador suporta as seguintes configurações:

    Setting Descrição
    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 cronograma começa
    Data e hora de fim Quando o cronograma 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. Esse parâmetro é necessário para definir a função que você está chamando.

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

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

    Nome do parâmetro Tipo
    nome String

    Important

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

  5. Salve o cronograma.

  6. Adicione mais agendas para outras funções no item da sua função de dados de usuário.

Execute uma função agendada manualmente

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 conexões e testar a lógica da função.

Monitorar execuções agendadas

Você pode monitorar a execução das funções de dados do usuário a partir da experiência de monitoramento do Fabric.

  1. Abra o Hub de Monitor.
  2. Selecione Atividades.
  3. Filtre por funções de dados do usuário.

Use a experiência de monitoramento para diagnosticar execuções fracassadas e validar execuções bem-sucedidas.

Configurar notificações de falha

Você pode configurar notificações por e-mail para execuções agendadas falhadas.

  1. Abra a página de Agenda.
  2. Nas notificações de falha, insira um ou mais endereços de e-mail.
  3. Salve a configuração.

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

Próximas Etapas 

  • Aprenda sobre as funções de dados do usuário.
  • Saiba mais sobre o agendador de tarefas no Fabric.
  • Monitore e solucione problemas das cargas de trabalho do Fabric usando o hub Monitor.
  • Last updated on