Edit

Share via

Use the invoke pipeline activity to run another pipeline

  • Article

The Fabric invoke pipeline activity can execute another Microsoft Fabric pipeline. You can use it to orchestrate the execution of one or multiple pipelines from within a single pipeline.

Prerequisites

To get started, you must complete the following prerequisites:

Note

There are currently two Invoke Pipeline activities (legacy and preview). The legacy invoke pipeline only supports Fabric pipelines in the same workspace as your parent pipeline. You can also only monitor the parent pipeline and cannot invoke ADF or Synapse pipelines using the legacy activity. Using the new preview invoke pipeline activity will allow you to invoke pipelines across Fabric workspaces, from ADF or Synapse, and monitor child pipelines.There is a current known limitation with the preview activity that prohibits the use of pipeline return values. This issue is being fixed and is temporary.

Add an invoke pipeline activity to a pipeline with UI

To use an invoke pipeline activity in a pipeline, complete the following steps:

Create the activity

  1. Create a new pipeline in your workspace.

  2. Search for invoke pipeline in the pipeline Activities pane, and select it to add it to the pipeline canvas.

    Screenshot of the Fabric UI with the Activities pane and Invoke pipeline activity highlighted.

    Screenshot showing the pipeline editor window with the Invoke pipeline button on the activities tab without its descriptive text.

  3. Select the new invoke pipeline activity on the canvas if it isn't already selected.

    Screenshot showing the General settings tab of the **invoke pipeline activity**.

Refer to the General settings guidance to configure the General settings tab.

Invoke pipeline settings

Select the Settings tab, and choose an existing pipeline from the invoke pipeline dropdown, or use the + New button to create a new pipeline directly. You can choose to wait on completion, or continue directly, in which case the invoked pipeline executes in parallel with activities following it within the parent pipeline's execution flow.

Screenshot showing the Invoke pipeline activity settings tab, highlighting the tab.

  • Connection: Each invoke pipeline activity requires a Connection object that is stored in the secure Fabric credentials store. This connection object stores your user token associated with your Fabric workspace. If you haven't yet created a new invoke pipeline activity, you'll be required to create a new connection object first before you can use the activity.

  • Workspace: Choose the Fabric workspace where the target pipeline is located that you wish to invoke from your parent pipeline.

Screenshot showing the pipeline editor window with the Invoke pipeline activity workspace and connection selection.

Invoke pipelines from ADF and Synapse

  • Type: Choose the source of your pipeline (Fabric, Azure Data Factory, Synapse)
  • Connection: Reference to Fabric, Azure Data Factory or Synapse registered as a connection
  • Pipeline: Select the pipeline name you wish to invoke

Screenshot showing the Invoke pipeline activity settings tab, highlighting ADF and Synapse.

Save and run or schedule the pipeline

Switch to the Home tab at the top of the pipeline editor, and select the save button to save your pipeline. Select Run to run it directly, or Schedule to schedule it. You can also view the run history here or configure other settings.

Screenshot showing the Home tab in the pipeline editor with the tab name, Save, Run, and Schedule buttons highlighted.

Related content