Run a workflow by hand

Start a workflow now, outside its schedule, for example after you fix a table or add a new one. Each start creates one run, which you follow in the runs table.

Before you start

Start a run

  1. In the sidebar, click Workflows.
  2. Hover over the workflow card and click the play button, whose tooltip reads Run. Or right-click the workflow's tab and choose Run.
  3. In the Run Workflow dialog, check the date under Select Date and the time under Select Time. For a normal run, leave both as they are.
  4. Check Workflow Info. It shows Name, Jobs (the number of tables in the workflow, or for a Warehouse workflow the number of transformations whose schedule is on), Status (Active or Inactive) and Latest Job (its status, or N/A).
  5. Click Start.

Cancel closes the dialog without starting a run. The Start button reads Running... while the start is sent. The dialog closes as soon as you click Start, so a refusal arrives afterwards as an Error notification with the reason.

After you click Start, a success notification reads Flow scheduled successfully. That message means the run has started. It does not mean the data has loaded.

The run appears in the runs table straight away with Execution Type set to Manual, and the runs list and the timeline refresh to show it. Follow the run in Job runs; to watch its steps, see Monitor and fix a run.

A run is planned when you start it, so its steps are fixed at that moment. A table added to the workflow afterwards waits for the next run.

Run Workflow settings

SettingWhat it doesDefault
Select DateSets the run's Current Date, the operation date the run works with.Today
Select TimeSets the time for that date, down to the second.Now
Note

The dialog sets only the run you start. It does not change the workflow's schedule or its settings.

When Run is greyed out

Run is disabled when the workflow has nothing to run yet. Hover over the disabled button to see Can’t run yet and the reason:

In the workflow tab's right-click menu, the item is disabled and reads Run - deploy a table first. While the panel is open, other cards keep their hover actions hidden.

If a start still reaches the server while the workflow has nothing ready, it is refused with Unable to start <name>, at least one table must be deployed.

Limits and edge cases

Questions, answered

Why is there no Run action on the card?

You do not have the Execute permission for that workflow's type. Ask an administrator for the matching Execute permission, such as Execute Lake Workflow Objects. See Workflow permissions.

Why is Run still greyed out after I deployed a table?

Run counts only the tables of this workflow. A deployed table that belongs to another workflow does not count. Move the table to this workflow from the Lake. See Workflows in the Lake.

What does the date in Run Workflow change?

It sets the run's Current Date, the operation date the run works with. The runs table shows it in the Current Date column. For a normal run, leave it as it is.

Can I run a workflow when its schedule is off?

Yes. The schedule switch does not stop a run you start by hand, and starting a run does not turn the schedule on.

Start says the workflow cannot start because there are unfinished jobs. What do I do?

A run of that workflow is still Running or Running Error. The message reads The <name> cannot start, there is unfinished job(s). Wait for the run to finish, or stop it: Stop is available while a run is Running or Running Error. See Monitor and fix a run.

Start says a data source is being loaded by another job. What do I do?

Another run is preparing or loading the same data source. The message reads Data source "<code>" is being loaded by job <id> (<workflow>). Start again once that job finishes. Start again when that run ends.

Can I run one table instead of the whole workflow?

Yes. Open the table in the Lake and click Synchronize to load that one table. Its run has Run Scope set to Single Node. See Run, stop and troubleshoot loads; to find the run, filter the Run Scope column in Job runs.

I got "Flow scheduled successfully". Has the data loaded?

Not yet. The run has started. Watch its Status in the runs table until it shows Finished. See Job runs.

What happens when Start is refused?

The dialog closes as soon as you click Start, so the refusal arrives afterwards as an Error notification with the reason from the server. When the server sends no reason, it reads An unexpected error occurred. Fix the cause, then start the run again. See Troubleshooting workflows.