Programar una función de datos de usuario

El planificador de tareas en Microsoft Fabric te permite ejecutar funciones de datos de usuario (UDFs) en un horario recurrente sin necesidad de una pipeline, un cuaderno o un servicio de orquestación externo. Puedes configurar los horarios directamente en una función de datos de usuario, especificar patrones de recurrencia, pasar parámetros de funciones y monitorizar ejecuciones desde la experiencia de monitorización de Fabric.

Prerequisites

Antes de crear un horario, asegúrate de que:

• Tienes una función de datos de usuario publicada.
• Tienes permisos de Colaborador o de un nivel superior en el espacio de trabajo.
• La función se prueba con éxito mediante invocación manual.
• Configuras las conexiones, secretos o dependencias necesarias.

Casos de uso

Programar funciones de datos de usuario para automatizar tareas comerciales y operativas recurrentes. Entre los escenarios habituales se incluyen los siguientes:

• Validación de la calidad de los datos – Realiza comprobaciones en conjuntos de datos antes de reportar o procesar aguas abajo.
• Procesamiento de opiniones de clientes – Analiza los nuevos feedbacks, genera puntuaciones de sentimiento y almacena resultados.
• Generación de eventos empresariales – Detectar cambios en los datos operativos y publicar eventos empresariales para aplicaciones posteriores.
• Limpieza programada – Archivar registros antiguos, eliminar archivos temporales o realizar tareas rutinarias de mantenimiento.
• Sincronización periódica de datos – Sincronizar datos de sistemas externos en Fabric en un horario recurrente.
• Notificaciones automáticas – Generar alertas o notificaciones basadas en reglas de negocio y umbrales.

Abre el planificador

1. Abra el área de trabajo de Fabric.
2. Abre el elemento de función de datos de usuario.
3. Haga clic en Configuración.
4. Seleccionar Programación.

La página de Horario te permite:

• Crear horarios
• Configuración de notificaciones de error
• Ver ejecuciones programadas
• Editar o desactivar los horarios
• Ejecutar manualmente trabajos programados

Crear programación

1. En Agenda, selecciona Añadir horario.

2. Configura las propiedades del horario.

   El planificador soporta las siguientes configuraciones:

   Configuración	Description
   Controller	Variable utilizada para controlar la ejecución desde la biblioteca de variables
   Repetir	Define el patrón de recurrencia
   Intervalo	Intervalo de frecuencia
   Fecha y hora de inicio	Cuando comienza la programación
   Fecha y hora de finalización	Cuando expire el calendario
   Zona horaria	Huso horario para la ejecución del calendario
   Parameters	Parámetros de entrada transmitidos a la función

   Selecciona con qué frecuencia debe ejecutarse la función y proporciona los detalles de la programación. El programador soporta ejecuciones recurrentes como cada pocos minutos, cada hora, diaria, semanal o mensual. Por ejemplo, para ejecutar una función cada 15 minutos, configure:

3. Proporciona el parámetro para FunctionName. Este parámetro es necesario para definir la función que estás llamando.

   Nombre del parámetro	Type	Importancia
   FunctionName (Nombre de la función)	String	nombre de las funciones, por ejemplo hello_fabric.

4. Añade más parámetros para las entradas de la función. Por ejemplo, para hello_fabric(name:str), añade un parámetro name de cadena de tipo.

   Nombre del parámetro	Type
   nombre	String

   Importante

   Los nombres de los parámetros deben coincidir exactamente con la firma de la función de datos del usuario. Los nombres de parámetro distinguen mayúsculas de minúsculas.

5. Guarde la programación.

6. Añade más programas para otras funciones en tu elemento de datos de usuario.

Ejecuta una función programada manualmente

Para probar una función programada inmediatamente, seleccione Ejecutar. Fabric envía una ejecución sin esperar al siguiente intervalo programado. La ejecución manual es útil para validar parámetros, verificar conexiones y probar la lógica de las funciones.

Monitorizar las ejecuciones programadas

Puedes monitorizar las ejecuciones de funciones de datos del usuario desde la experiencia de monitorización de Fabric.

1. Abre el Monitor Hub.
2. Seleccione Actividades.
3. Filtrar por funciones de datos de usuario.

Utiliza la experiencia de monitorización para diagnosticar ejecuciones fallidas y validar ejecuciones exitosas.

Configuración de notificaciones de error

Puedes configurar notificaciones por correo electrónico para ejecuciones programadas fallidas.

1. Abre la página de Horarios .
2. En notificaciones de fallo, introduce una o más direcciones de correo electrónico.
3. Guarde la configuración.

Fabric envía notificaciones por correo electrónico cada vez que falla una ejecución programada.

Pasos siguientes

• Aprende sobre las funciones de datos del usuario.
• Infórmate sobre el planificador de tareas en Fabric.
• Monitoriza y soluciona las cargas de trabajo de Fabric usando el hub Monitor.