Programmare una funzione dati utente

Il pianificatore di lavoro in Microsoft Fabric ti permette di eseguire le funzioni dati utente (UDF) su una programmazione ricorrente senza richiedere una pipeline, un notebook o un servizio di orchestrazione esterno. Puoi configurare gli orari direttamente su una funzione dati utente, specificare i pattern di ricorrenza, passare i parametri della funzione e monitorare le esecuzioni dall'esperienza di monitoraggio Fabric.

Prerequisiti

Prima di creare un programma, assicurati che:

• Hai una funzione dati utente pubblicati.
• Hai permessi Contributor o di livello superiore sullo spazio di lavoro.
• La funzione viene testata con successo tramite invocazione manuale.
• Configuri tutte le connessioni, segreti o dipendenze necessarie.

Situazioni di utilizzo

Programmare le funzioni dati degli utenti per automatizzare le attività ricorrenti di business e operative. Gli scenari comuni includono:

• Validazione della qualità dei dati – Eseguire controlli sui dataset prima di fare report o processare a valle.
• Elaborazione dei feedback dei clienti – Analizza i nuovi feedback, genera punteggi di sentiment e memorizza i risultati.
• Generazione di eventi aziendali – Rilevare cambiamenti nei dati operativi e pubblicare eventi aziendali per applicazioni a valle.
• Pulizia programmata – Archiviare i vecchi documenti, rimuovere file temporanei o eseguire compiti di manutenzione di routine.
• Sincronizzazione periodica dei dati – Sincronizzare i dati provenienti da sistemi esterni in Fabric su un programma ricorrente.
• Notifiche automatiche – Genera avvisi o notifiche basate su regole aziendali e soglie.

Apri il scheduler

1. Aprire l'area di lavoro di Fabric.
2. Apri l'elemento della funzione dati utente.
3. Seleziona Impostazioni.
4. Selezionare Pianifica.

La pagina Programma ti permette di:

• Crea orari
• Configurare le notifiche di errore
• Visualizza le esecuzioni programmate
• Modifica o disabilita gli orari
• Esegui manualmente i lavori programmati

Creare una programmazione

1. Su Programma, seleziona Aggiungi programma.

2. Configura le proprietà di programmazione.

   Il scheduler supporta le seguenti impostazioni:

   Setting	Description
   Controller	Variabile utilizzata per controllare l'esecuzione dalla libreria variabile
   Ripeti	Definisce il modello di ricorrenza
   Intervallo	Intervallo di frequenza
   Data e ora di inizio	Quando inizia il calendario
   Data e ora di fine	Quando scade il calendario
   Fuso orario	Fuso orario per l'esecuzione della pianificazione
   Parameters	Parametri di input passati alla funzione

   Seleziona con quale frequenza la funzione deve essere eseguita e fornisci i dettagli della programmazione. Il scheduler supporta esecuzioni ricorrenti come ogni pochi minuti, ogni ora, giornaliere, settimanale o mensilmente. Ad esempio, per eseguire una funzione ogni 15 minuti, configurare:

3. Fornire il parametro per FunctionName. Questo parametro è necessario per definire la funzione che stai chiamando.

   Nome del parametro	Type	Value
   FunctionName	Stringa	Nome delle funzioni, ad esempio hello_fabric.

4. Aggiungi altri parametri per gli input delle funzioni. Ad esempio, per hello_fabric(name:str), aggiungi un parametro name di stringa di tipo.

   Nome del parametro	Type
   nome	Stringa

   Importante

   I nomi dei parametri devono corrispondere esattamente alla firma della funzione dati utente. I nomi dei parametri fanno distinzione tra maiuscole e minuscole.

5. Salva il programma.

6. Aggiungi più schedari per altre funzioni nell'elemento della funzione dati utente.

Esegui manualmente una funzione programmata

Per testare immediatamente una funzione programmata, seleziona Esegui. Fabric invia un'esecuzione senza attendere il prossimo intervallo programmato. L'esecuzione manuale è utile per validare parametri, verificare le connessioni e testare la logica delle funzioni.

Monitorare le esecuzioni programmate

Puoi monitorare le esecuzioni delle funzioni dati utente dall'esperienza di monitoraggio Fabric.

1. Apri il Monitor Hub.
2. Selezionare Attività.
3. Filtra per funzioni dati utente.

Usa l'esperienza di monitoraggio per diagnosticare esecuzioni fallite e convalidare le esecuzioni riuscite.

Configurare le notifiche di errore

Puoi configurare le notifiche via email per le esecuzioni programmate fallite.

1. Apri la pagina Programma .
2. Nelle notifiche di fallimento, inserisci uno o più indirizzi email.
3. Salva la configurazione.

Fabric invia notifiche email ogni volta che un'esecuzione programmata fallisce.

Passaggi successivi

• Scopri le funzioni dati dell'utente.
• Scopri il pianificatore di lavori in Fabric.
• Monitorare e risolvere i carichi di lavoro Fabric utilizzando l'hub Monitor.