Microsoft Fabric
Actividad Invoke Pipeline de Microsoft Fabric: crea pipelines modulares y reutilizables
Usa la actividad Invoke Pipeline de Microsoft Fabric para componer pipelines padre e hijo parametrizados entre áreas de trabajo, con conexiones seguras y monitorización práctica.
En este artículo
Un pipeline que ingiere, valida, transforma, publica, notifica y registra todo en un solo lienzo puede funcionar al principio. Cuando crece, reutilizarlo y probarlo resulta más difícil, la orquestación pierde claridad y cada cambio aumenta el radio de impacto.
La actividad Invoke Pipeline aporta un límite de composición a los pipelines de Fabric. Un padre decide qué se ejecuta y cuándo; un hijo se ocupa de una unidad de trabajo concreta. Este artículo construye ese patrón con parámetros, explica las conexiones y las identidades, y muestra cómo monitorizar la ejecución completa.
Qué hace Invoke Pipeline
Invoke Pipeline es una actividad de flujo de control. Inicia otro pipeline y puede pasar valores a sus parámetros.
- Pipeline padre / orquestador
- Invoke Pipeline
- Pipeline hijo reutilizable
La actividad actual puede invocar un pipeline de Fabric en la misma área de trabajo o en otra, además de pipelines de Azure Data Factory y Azure Synapse.
Cada actividad usa un objeto de conexión almacenado en el almacén seguro de credenciales de Fabric. Para un destino Fabric se eligen la conexión, el área de trabajo y el pipeline. Para ADF o Synapse se eligen el tipo de origen, su conexión registrada y el nombre del pipeline.
Microsoft documenta Invoke Pipeline e Invoke Pipeline (Legacy). La actividad heredada solo llama a pipelines Fabric del área del padre y solo permite monitorizar el padre. La actual añade destinos entre áreas de trabajo y plataformas, además de monitorización de los hijos. Para diseños nuevos, usa normalmente la actividad actual.
Pipeline padre y pipeline hijo
Usa un único ejemplo pequeño en todo el artículo, creado en un área de trabajo de demostración como Javi Builds Fabric Demo. PL_Sales_Orchestrator es el padre. Invoca PL_Load_Sales_Daily, espera el resultado y solo entonces continúa con el resto del flujo.
- PL_Sales_Orchestrator
- Invoke Pipeline
- PL_Load_Sales_Daily
- Esperar a que termine
- Continuar el flujo
El padre controla la programación, la secuencia global y las notificaciones. El hijo controla la validación y el procesamiento idempotente de una fecha de negocio y una región. Después podrá reutilizarse en un backfill, una reejecución de soporte o el Lab 02 — Parameterized Pipelines and Incremental Processing, sin duplicar lógica.
| Parámetro | Tipo | Ejemplo | Finalidad |
|---|---|---|---|
p_date |
String | 2026-10-19 |
Fecha de negocio que se carga |
p_region |
String | US |
Región que se procesa |
Pasar la fecha de negocio explícitamente hace predecibles las reejecuciones: volver a ejecutar 2026-10-19 recarga esa fecha, no el «hoy» del momento en que arranca el hijo.
Añadir la actividad Invoke Pipeline actual
Crea PL_Sales_Orchestrator, abre el panel Activities y añade la actividad Invoke Pipeline actual, no Invoke Pipeline (Legacy). Llámala Invoke_PL_Load_Sales_Daily y conéctala donde deba ejecutarse la carga reutilizable: después de los pasos de preparación y antes del trabajo que depende de los datos cargados.
Configurar el pipeline de destino
Crea PL_Load_Sales_Daily en la misma área de demostración, o en otra área de demostración segura si pruebas una invocación entre áreas. En la configuración de Invoke Pipeline, establece el tipo de destino en Fabric, elige una conexión segura, selecciona el área de destino cuando corresponda, selecciona PL_Load_Sales_Daily y deja activado Wait on completion.
Las llamadas dentro de la misma área se configuran rápido. Las llamadas entre áreas requieren una conexión compatible y una identidad autorizada en el área de destino; las opciones de identidad se explican más abajo, con las consideraciones de producción.
Pasar parámetros del padre al hijo
Define p_date y p_region en PL_Load_Sales_Daily. Valida su formato y sus valores permitidos, asígnalos a la actividad hija que realiza la carga y prueba el hijo directamente con 2026-10-19 y US antes de invocarlo desde el padre.
- Añade los dos parámetros del hijo con valores predeterminados de demostración.
- Asígnalos a la actividad Notebook, Copy o Stored Procedure que realiza la carga.
- Valida el formato de fecha y la lista permitida de regiones antes de escribir.
- Haz idempotente la carga para que un reintento converja en el mismo resultado.
- Escribe el id. de ejecución del hijo, los valores de los parámetros, el estado y recuentos seguros en el registro de ejecución.
Para un notebook hijo:
| Parámetro base | Valor dinámico |
|---|---|
p_date |
@pipeline().parameters.p_date |
p_region |
@pipeline().parameters.p_region |
Así el hijo sigue siendo comprobable por sí solo, antes de que intervenga el padre.
Asignar los valores del padre
Da a PL_Sales_Orchestrator sus propios parámetros p_date y p_region y asigna cada parámetro del hijo en la configuración de Invoke Pipeline:
| Parámetro hijo | Valor del padre |
|---|---|
p_date |
@pipeline().parameters.p_date |
p_region |
@pipeline().parameters.p_region |
Las expresiones dinámicas permiten que un mismo padre procese cualquier fecha y región. Un valor estático como US también es válido si un padre solo procesa una región, pero fija esa decisión en la orquestación.
Ejecuta el padre con 2026-10-19 y US, comprueba qué recibió el hijo y prueba después una fecha o región no válida para confirmar que la validación falla de forma segura.
waitOnCompletion define el contrato de dependencia
Con waitOnCompletion en true —el valor predeterminado documentado en la definición del pipeline— la actividad sigue activa hasta que termina el hijo. Una dependencia de éxito significa entonces «el hijo terminó correctamente». Úsalo antes de publicaciones, controles de calidad o notificaciones dependientes del resultado.
Con false, el padre continúa después de enviar el hijo. Las actividades posteriores pueden solaparse y no deben interpretar el envío como prueba de que el procesamiento terminó.
- Invocar el pipeline hijo
- waitOnCompletion = true
- Esperar el resultado del hijo
- Publicar o notificar
- waitOnCompletion = false
- Continuar tras el envío
- Trabajo paralelo independiente
El modo «enviar y continuar» solo es útil cuando el trabajo siguiente es realmente independiente y otro mecanismo detecta los fallos del hijo. No es un atajo para una dependencia que sigue existiendo.
En la definición, Microsoft documenta actualmente ExecutePipeline como el tipo moderno; InvokePipeline es el tipo obsoleto. Un fragmento simplificado tiene este aspecto:
{
"name": "Invoke_PL_Load_Sales_Daily",
"type": "ExecutePipeline",
"typeProperties": {
"pipeline": {
"referenceName": "PL_Load_Sales_Daily",
"type": "PipelineReference"
},
"parameters": {
"p_date": "@pipeline().parameters.p_date",
"p_region": "@pipeline().parameters.p_region"
},
"waitOnCompletion": true
}
}
Es un fragmento explicativo, no un archivo de despliegue portátil: una exportación puede incluir directivas, conexiones e identificadores del entorno.
Ejecutar y monitorizar toda la cadena
Usa Output para la ejecución inmediata y la monitorización e historial de Fabric para investigar. La actividad actual permite navegar hasta las ejecuciones hijas, algo esencial cuando el padre solo indica que un paso invocado falló.
En una ejecución correcta, comprueba que PL_Sales_Orchestrator muestra la actividad Invoke_PL_Load_Sales_Daily, que la ejecución hija PL_Load_Sales_Daily recibió 2026-10-19 y US, y que el estado y la duración son razonables en ambos niveles. Para profundizar, lee Monitorizar pipelines y notebooks de Fabric y Diseñar un registro de ejecución para pipelines de datos.
Registra de forma duradera: identificadores padre e hijo, nombres, destino, valores de p_date y p_region, marcas de tiempo, estado, error seguro, recuentos y watermark. No registres secretos. Activa entradas/salidas seguras cuando corresponda. Una correlación que el padre pasa al hijo convierte el árbol de ejecuciones en una sola operación localizable.
Gestionar los fallos del hijo
Con waitOnCompletion = true, un fallo del hijo afecta directamente a la actividad del padre, porque el padre está esperando el resultado. Revisa primero la actividad Invoke Pipeline fallida y abre después la ejecución hija para encontrar la actividad y el error que causaron el fallo. Comprueba ambos niveles: el padre aporta el contexto de orquestación y el hijo contiene el detalle del procesamiento.
Con waitOnCompletion = false, el padre continúa tras el envío y no espera el resultado final del hijo. Por tanto, una ruta de monitorización o alertas independiente debe encargarse de detectar los fallos del hijo. No coloques trabajo que dependa del resultado después de una invocación de tipo «enviar y continuar».
Elegir la identidad de conexión
| Autenticación | Buen uso | Consideración operativa |
|---|---|---|
| Organizational account | Desarrollo interactivo y primeras pruebas | Depende de una persona y del ciclo de vida de su token |
| Service principal | Automatización no interactiva con identidad de aplicación | Configuración del tenant, secretos/certificados y permisos |
| Workspace Identity | Identidad de carga alineada con el área que llama | Debe crearse en el origen y recibir acceso al destino |
Para Workspace Identity, Microsoft exige actualmente que la identidad esté en la misma área de trabajo que el pipeline que llama, que esté habilitada la opción del tenant Service principals can call Fabric public APIs y que exista acceso suficiente al destino. En llamadas entre áreas, concede a esa identidad acceso al área de destino; Microsoft indica que Contributor basta en la mayoría de los casos. Aplica privilegio mínimo.
La compatibilidad general de Workspace Identity con conexiones de Data Factory no otorga automáticamente permiso para invocar un pipeline: también importa la autorización del área de destino.
Patrones de producción y errores frecuentes
Sitúa el patrón dentro de una arquitectura de Microsoft Fabric deliberada y promuévelo con una integración de Git en Fabric revisada y CI/CD con fabric-cicd. El laboratorio de analítica de ventas de extremo a extremo en Fabric sirve para practicar el área de trabajo, los pipelines y la monitorización con datos sintéticos.
Mantén cada hijo cohesionado. «Cargar un conjunto acotado» es una responsabilidad útil; «hacer lo que pida el padre» solo traslada el monolito. Versiona con cuidado el contrato de parámetros y evita cadenas profundas de invocación.
- valida los parámetros dentro del hijo;
- pasa el tiempo de negocio explícitamente;
- reintenta solo trabajo transitorio e idempotente;
- prueba el hijo y después el contrato padre-hijo;
- externaliza identificadores, conexiones e identidades por entorno;
- usa
waitOnCompletion = falsesolo con monitorización asíncrona explícita.
Fabric frente a Azure Data Factory
El patrón resulta familiar para ADF, pero Fabric usa objetos de conexión en lugar de servicios vinculados de ADF y no emplea artefactos Dataset de la misma forma. Fabric usa Save y Run, se integra con áreas de trabajo y OneLake, y ofrece la experiencia Invoke Pipeline entre plataformas. En ADF, la actividad equivalente se llama Execute Pipeline.
No supongas que una definición ADF exportada se puede pegar sin cambios en Fabric. Las expresiones son parecidas, pero conexiones, referencias, despliegue y monitorización pertenecen al modelo de Fabric.
Lista de comprobación
- una responsabilidad clara para el hijo;
- nombres, tipos y límites de parámetros documentados;
- reintentos y reejecuciones idempotentes;
- identidad de producción no personal;
- permisos explícitos entre áreas;
- espera coherente con las dependencias;
- correlación padre-hijo;
- errores visibles en monitorización y registros;
- hijo comprobable sin el padre.
Cuándo usar Invoke Pipeline
Usa Invoke Pipeline cuando una unidad de trabajo merece su propio límite:
- varios padres necesitan la misma carga, por ejemplo una programación diaria, un backfill y una reejecución de soporte;
- el hijo debe probarse, tener un responsable o cambiar con independencia de la orquestación;
- el trabajo vive en otra área de trabajo de Fabric, o en Azure Data Factory o Azure Synapse.
Mantén las actividades en un solo pipeline cuando solo tienen sentido juntas y nada más las va a llamar. Un pipeline hijo añade un contrato de parámetros, una conexión y una segunda ejecución que monitorizar: ese coste compensa para reutilizar y aclarar responsabilidades, no para cada grupo de actividades.
Invoke Pipeline es ante todo un límite arquitectónico. Un padre ligero, un contrato estable y un hijo observable convierten un conjunto creciente de pipelines en componentes reutilizables.
Próximos pasos
- Monitorizar pipelines y notebooks de Fabric: seguir las ejecuciones padre e hijo en producción.
- Diseñar un registro de ejecución para pipelines de datos: guardar de forma duradera identificadores, parámetros y resultados.
- CI/CD de Microsoft Fabric con fabric-cicd e integración de Git en Fabric: promover juntos los pipelines padre e hijo entre entornos.
- Hub de Microsoft Fabric: el recorrido de aprendizaje completo.
Fuentes y lecturas adicionales
¿Te resultó útil este contenido?
¿Qué podríamos mejorar?
Gracias — esto me ayuda a mejorar Javi Builds.
Sigue aprendiendo
- Guía rápidaDepurar pipelines de FabricDiagnostica los fallos de pipelines de Microsoft Fabric aislando la actividad que falló, separando los errores transitorios de los deterministas, validando parámetros e identidades, y usando reintentos, registro y re-ejecuciones controladas de forma segura.Abrir guía rápida
- ArtículoParámetros de notebooks en Microsoft Fabric: patrones prácticos para pipelines reutilizablesHaz que un mismo notebook de Fabric sirva para muchas ejecuciones: celda de parámetros, parámetros base del pipeline, validación, ventanas de fechas, entornos, secretos, logging seguro y pruebas.Leer artículo
¿Qué debería crear después?
Estoy construyendo Javi Builds alrededor de problemas reales que enfrentan los ingenieros de datos. Dime qué tema te gustaría ver después.
Mantente al día
Recibe solo las novedades de Javi Builds que realmente te interesan.
Revisa tu bandeja de entrada
Te he enviado un enlace de confirmación. Tu suscripción se activará cuando la confirmes.