Planifier une fonction de données utilisateur

Le planificateur de tâches dans Microsoft Fabric vous permet d’exécuter des fonctions de données utilisateur (UDF) sur un calendrier récurrent sans nécessiter de pipeline, de notebook ou de service d’orchestration externe. Vous pouvez configurer les plannings directement sur une fonction de données utilisateur, spécifier des schémas de récurrence, passer les paramètres de la fonction et surveiller les exécutions depuis l’expérience de surveillance Fabric.

Prerequisites

Avant de créer un planning, assurez-vous que :

• Vous avez une fonction de données utilisateur publiées.
• Vous avez des permissions Contributeur ou supérieures sur l’espace de travail.
• La fonction est testée avec succès en utilisant une invocation manuelle.
• Vous configurez toutes les connexions, secrets ou dépendances nécessaires.

Cas d’utilisation

Planifiez les fonctions de données utilisateur pour automatiser les tâches récurrentes de l’entreprise et des opérations. Les scénarios courants sont les suivants :

• Validation de la qualité des données – Effectuer des vérifications sur les ensembles de données avant de faire des rapports ou de traiter en aval.
• Traitement des retours clients – Analysez les nouveaux retours, générez des scores de sentiment et stockez les résultats.
• Génération d’événements métier – Détecter les changements dans les données opérationnelles et publier les événements métier pour les applications en aval.
• Nettoyage programmé – Archiver les anciens enregistrements, supprimer des fichiers temporaires ou effectuer des tâches de maintenance de routine.
• Synchronisation périodique des données – Synchroniser les données des systèmes externes vers Fabric selon un calendrier récurrent.
• Notifications automatisées – Générez des alertes ou notifications basées sur les règles métier et les seuils.

Ouvre le planificateur

1. Ouvrez votre espace de travail Fabric.
2. Ouvrez l’élément de fonction données utilisateur.
3. Sélectionnez Paramètres.
4. Sélectionnez Planification.

La page Planning vous permet de :

• Créer des plannings
• Configurer les notifications d’échec
• Voir les exécutions programmées
• Modifier ou désactiver les plannings
• Exécuter manuellement les tâches planifiées

Créer une planification

1. Dans Planification, sélectionnez Ajouter une planification.

2. Configurez les propriétés de la programmation.

   Le planificateur prend en charge les paramètres suivants :

   Setting	Description
   Controller	Variable utilisée pour contrôler l’exécution à partir de la bibliothèque de variables
   Répéter	Définit le schéma de récurrence
   Intervalle	Intervalle de fréquence
   Date et heure de début	Quand le calendrier commence
   Date et heure de fin	Quand le calendrier expire
   Fuseau horaire	Fuseau horaire pour l’exécution du planning
   Parameters	Paramètres d’entrée transmis à la fonction

   Sélectionnez la fréquence d’exécution de la fonction et fournissez les détails de la planification. Le planificateur prend en charge des exécutions récurrentes telles que toutes les quelques minutes, toutes les heures, quotidiennement, hebdomadaire ou mensuellement. Par exemple, pour exécuter une fonction toutes les 15 minutes, configurez :

3. Fournir un paramètre pour FunctionName. Ce paramètre est nécessaire pour définir la fonction que vous appelez.

   Nom du paramètre	Type	Valeur
   FunctionName	String	nom des fonctions, par exemple hello_fabric.

4. Ajoutez plus de paramètres pour les entrées de fonction. Par exemple, pour hello_fabric(name:str), ajouter un paramètre name de chaîne de type .

   Nom du paramètre	Type
   nom	String

   Important

   Les noms de paramètres doivent correspondre exactement à la signature de fonction des données utilisateur. Les noms de paramètres respectent la casse.

5. Enregistrez le planning.

6. Ajoutez plus de plannings pour d’autres fonctions dans votre élément de fonction de données utilisateur.

Exécuter manuellement une fonction planifiée

Pour tester immédiatement une fonction planifiée, sélectionnez Exécuter. Fabric soumet une exécution sans attendre le prochain intervalle planifié. L’exécution manuelle est utile pour valider les paramètres, vérifier les connexions et tester la logique des fonctions.

Surveillez les exécutions programmées

Vous pouvez surveiller les exécutions des fonctions de données utilisateur depuis l’expérience de surveillance Fabric.

1. Ouvre le Monitor Hub.
2. Sélectionnez Activités.
3. Filtrer par fonctions de données utilisateur.

Utilisez l’expérience de surveillance pour dépanner les échecs et valider les exécutions réussies.

Configurer les notifications d’échec

Vous pouvez configurer des notifications par email pour les échecs des exécutions programmées.

1. Ouvrez la page Planning.
2. Dans les notifications d’échec, saisissez une ou plusieurs adresses e-mail.
3. Enregistrez la configuration.

Fabric envoie des notifications par e-mail chaque fois qu’une exécution programmée échoue.

Étapes suivantes

• Apprenez-en plus sur les fonctions de données utilisateur.
• Découvrez le planificateur de tâches dans Fabric.
• Surveillez et dépannez les charges de travail Fabric en utilisant le hub Monitor.