Skip to main content

Flow Runs

Note

The flows feature is currently only available for:

  • Hybrid Clean Rooms

  • Hybrid Confidential Compute Clean Rooms

  • Snowflake Clean Rooms

The Flow Runs page displays a list of all flow runs, allowing you to monitor their status, view details, and access their outputs.

There are three ways you can run a flow:

  • Create a new flow run: You can create a new flow run to run the entire flow or just part of the flow. For more information, see “Create a Flow Run”.

  • Reuse a flow run: You can execute an existing flow run again to save processing time, reduce compute costs, and preserve output values. For more information, see “Reuse a Flow Run” below.

  • Schedule a flow run: You can set up flows to run automatically on a recurring basis (e.g., daily, weekly, monthly), removing the need for manual intervention each time you want the flow to run. For more information, see “Create a Scheduled Flow Run”.

Procedure. To access the Flow Runs page:

  1. Select Flows from the LiveRamp Clean Room navigation pane:

    flows-cr-left-nav-08012025-01.png

  2. Click the flow’s Run & Reports menu and select View Run Reports to view previous runs of this flow.

    Note

    This option is only available if the flow has been run. For more details, see "Create a Flow Run”.

    flows-more-options-view_flow_runs-08182025-01.png

    The Flow Runs page displays and lists the flow runs for the flow.

    flow-runs-paused-main-09292025.png

You can switch between "Card View" to display flow runs as cards and "List View" to display them in a table with column headings.

flows-runs-main-card-list-view-08182025-01.png

Columns Available on the Flow Runs Page

Note

You must be in “List View” to display column headings in the flows table.

Column Name

Description

Status

The status of this flow run:

  • Completed: The flow run completed successfully.

  • Failed: The flow run failed to complete.

  • Paused: The flow run paused at the Level indicated when the run was configured, see “Create a Flow Run” and “Resume a Paused Flow Run”.

  • Running: The flow run is currently running.

Run ID

The ID of the flow run.

Name

The name of the flow run.

Scheduled

Whether the flow run is scheduled.

Created By

The user who created the flow run.

Created On

The date and time the flow run was created: MM/DD/YYYY HH:MM AM/PM

Parent Run ID

The ID of the parent run if this run is reused. Click the link to open the parent run.

Actions

Available actions for the flow run include: "View report" to view output of nodes in the flow, and "More Options" (more-options-icon.png) menu to reuse or delete a flow run.

Sort and Filter Flow Runs

Procedure. To sort flow runs:

  1. On the Flow Runs page, click Filters & Search to display the Sort By and Filter by Job Status fields.

    flows-runs-main-search-01-08182025-01.png

  2. To sort the flow runs, click the Sort By drop-down list and select a field to sort the flows by: None, Status, Created On, Created By, or Name.

    flows-runs-main-search-02-08182025-01.png

  3. To change the sorting order between descending and ascending order, click Desc (descending) or Asc (ascending).

  4. To filter flow runs by status, click the Filter by Job Status drop-down list and select a filter: All, Completed, or Failed.

    flows-runs-main-search-03-08182025-01.png

Actions You Can Perform from the Flow Runs Page

  • View flow run report: Click the flow run’s View Report button to view node outputs for the flow run. For more information, see “View Node Outputs in a Flow Run Report” below.

  • Resume paused flow runs: Select the desired flow run’s More Options (more-options-icon.png) menu and click Resume. For more information, see “Resume a Paused Flow Run” below.

  • Reuse flow runs: Select the desired flow run’s More Options (more-options-icon.png) menu and click Reuse. For more information, see “Reuse a Flow Run” below.

  • Delete a flow run: Select the desired flow run’s More Options (more-options-icon.png) menu and click Delete.

    Note

    The “Delete” option is not enabled if a flow run is a parent (base) run to a child run (a reused run of the parent run). To delete a parent flow run, all child runs must first be deleted.

View Node Outputs in a Flow Run Report

When you select View Report for a specific flow run, a detailed view opens, allowing you to examine the output of each node in the flow.

flow-runs-output-01-08182025-01.png

The flow run report page lets you perform the following actions:

  • Choose the version of the flow run: A dropdown at the top allows you to switch between different runs for the same flow.

  • View a node’s output status: The “Node Output” column lists each node (question) within the flow. Each node indicates its output status:

    • Completed: The node successfully ran and output data.

    • Failed: The node failed to run successfully and did not output data.

    • Paused: The node did not run because the flow run was configured to pause at the node’s level. For more information, see “Resume a Paused Flow Run” below.

    • Upstream Failure: Node not run (tooltip of unavailable node): There was a failure in the flow run prior to this node. This node did not run.

  • Select a node to view its output: The “Node Output” column lists each node (question) within the flow. Select a node in this column to view its specific output details.

flow-runs-output-01A-08182025-01.png

When you select a node in the Node Output column, the node output report displays:

flow-runs-output-03-08182025-01.png

The node output report contains the following information:

  • Flow run details: A panel under the flow run name displays high-level details about the selected flow run, including:

    • Flow Version: The version of the flow run.

    • Node ID: The node ID of the selected node.

    • CRQ ID: The Clean Room Question (CRQ) ID that the node is associated with.

    • Question Run ID: The ID of the question run associated with the node.

    • Question Version: The version of the CRQ associated with the node.

    • Level: The order of the node in the flow:

      • Level 0 = Nodes that begin a flow when the flow runs

      • Level 1 = Nodes that run after Level 0 nodes complete

      • Level 2 = Nodes that run after Level 1 nodes complete

      • etc.

    • Question Name: The name of the question node.

    • Runtime Parameter: Table listing any runtime parameters for this flow run.

  • Question Specific Filters: These let you filter the node's output data that appears in the table view by selecting fields in the available filter drop-downs, and clicking Go. More than one filter can be selected.

  • Sort Table: Provides options to sort the table view of the node's output in ascending or descending order based on a selected parameter in the Select Sort By drop-down list.

  • Table View: Displays the data output for the selected node.

  • Download CSV: Allows you to download the output data for the selected node as a CSV file.

Resume a Paused Flow Run

A flow run can be “paused” during execution if a level (e.g., “Level 0”, “Level 1”, etc.) was selected in the “Pause at” drop-down when the flow run was configured. A paused flow run has a status of “Paused” in the “Status” column of the Flow Runs page.

flow-runs-paused-main-labeled-09292025.png
Procedure. To resume a paused flow run:

  1. On the Flow Runs page, select the desired flow run’s More Options (more-options-icon.png) menu and click Resume.

    flow-runs-paused-resume-09292025.png

    The Resume Paused Run page displays the flow with the nodes in the paused level highlighted.

    flow-runs-paused-resume-paused-run-01-09292025.png

  2. (Optional) If there are additional levels to run after the paused level, you can select a subsequent level to pause the run at. If no level is selected, the run will execute to the end of the flow.

    flow-runs-paused-resume-paused-run-02-09292025.png

  3. Click Start Run to start the flow run. The Flow Runs page will display the resumed flow run with a status of “Running”.

    flow-runs-paused-resume-paused-run-03-09292025.png

Reuse a Flow Run

Tip

If you’ve made edits to a flow, consider creating a new flow run to verify its output before reusing it.

You can reuse a previously executed flow run by running a new flow run based on it. Reusing a flow run lets you save processing time, reduce compute costs, and preserve output values. If you’ve run a multi-node flow and already processed certain steps of the flow, you can restart from a specific intermediate point, avoiding redundant computations for steps that have already provided valid outputs.

Note

  • Only flows with a “Stage” value of “Ready” can be reused.

  • Flow runs with a “Status” of “Completed”, “Failed”, or “Paused” can be reused.

Procedure. To reuse a flow run:

  1. On the Flow Runs page, select the desired flow run’s More Options (more-options-icon.png) menu and click Reuse.

    flow-runs-reuse-more-options-08182025-01.png

    The Reuse Cached Report page displays:

    flow-runs-reuse-01-09292025-01.png

  2. In the “Reuse Settings” step, enter the following information:

    flow-runs-reuse-02-09292025-01.png

    • In the Begin at drop-down, select the Level of the flow you want the reuse to begin from. Level 0 = the beginning node(s) of the flow, Level 1 = the next node(s) in the flow, etc.

    • (Optional) In the Pause at drop-down, select the Level of the flow you want the reuse to pause at. If you don’t select a pause Level, all levels will run after the Level selected in the “Begin at” drop-down above.

    • (Optional) In the Run Name drop-down, enter a name for this reused flow run. The field is prepopulated with the name of the flow run you are reusing, but you can revise this if desired.

    • (Optional) In the Branch Names drop-down, select the branch names to filter the running of the flow. Leave this unselected to run all branches in the flow. For more information, see “Understanding Flow Run Branching”

    • (Optional) Select the Exclude nodes without tags checkbox to exclude any untagged nodes from this reused flow run. This checkbox is only enabled if one or more tags are selected in the “Branch Names” drop-down. For more information, see “Understanding Flow Run Branching”

  3. Click Next.

  4. In the “Set Parameters” step, enter values for the runtime parameters for each Level in the flow run.

    flow-runs-reuse-step-2-08182025-01.png

  5. Click Start Run to start the flow run. The Flow Runs page will display the reused flow run with a status of “Running”.

    flow-runs-paused-resume-paused-run-03-09292025.png

Understanding Flow Run Branching

You can tag nodes in a flow to control what branches of a flow execute in a new or reused flow run. After tagging the desired nodes, these tags will appear in the "Branch Names" drop-down on the "Run Details" page for new runs or the "Reuse Settings" page for reused runs. To include specific branches in your flow run, select the corresponding tags from the "Branch Names" drop-down when configuring the run. For a comparison of the different settings for new and reused flow runs, see "Understanding New and Reused Flow Run Settings" below.

If you have selected one or more node tags in the "Branch Names" drop-down when configuring a flow, the following rules apply at the starting level (Level 0 for new runs, or the "Begin at" level for reused runs) and all subsequent levels:

  • The run will include all tagged nodes that match the selected tags in the “Branch Names” drop-down. If a tagged child node matches a selected tag and depends on a tagged parent node to run, the parent node must also match the selected tags for the child node to run.

    Note

    If the “Ignore parent-child rules checkbox” is selected (only available for new flow runs), the run will exclude the parent nodes of any tagged child nodes that match the selected tags in the “Branch Names” drop-down. For more information, see “Create a Flow Run”.

  • The run will exclude all tagged nodes that do not match the selected tags in the “Branch Names” drop-down.

  • The run will include all untagged nodes, unless the 'Exclude nodes without tags' option is selected.

  • The run will include all subsequent child nodes that depend on nodes that match the selected tags in the “Branch Names” drop-down.

Note

For reused flow runs, data from any required parent nodes that precede the designated starting level (set in the "Begin at" drop-down) will be reused from the initial base run rather than rerunning those parent nodes. However, if a parent node did not run in the base run, it will not have any data to reuse, and the reused run will fail.

You can identify whether a parent node did not run by checking its status in the Flow Run Report page. To learn more, see “View Node Outputs in a Flow Run Report”.

Understanding New and Reused Flow Run Settings

The options available for a new flow run are slightly different from the options available for a reused run. Below is a comparison of these settings.

New Flow Run

A new flow run has the following available settings:

flow-runs-new-settings-01-10032025-01.png

  • Run Name (required)

  • Pause at (optional)

  • Branch Name (optional)

  • Execute nodes without tags (optional)

  • Ignore parent-child rules (optional)

For more information about these settings, see “Create a Flow Run”.

Reused Flow Run

A reused flow run has the following available settings:

flow-runs-reuse-settings-01-10032025.png

  • Begin at (required)

  • Pause at (optional)

  • Run Name (optional to revise)

  • Branch Name (optional)

  • Exclude nodes without tags (optional)

For more information about these settings, see “Reuse a Flow Run” above.

In this section: