All Products
Search
Document Center

DataWorks:Dry-run

Last Updated:Aug 17, 2026

What is a dry-run?

For nodes scheduled to run on specific days of a week, month, or year, the system still creates an instance at the scheduled time on other days. However, these instances are dry-runs and do not process any data. A dry-run instance behaves as follows:

  • It is immediately marked as successful with a run duration of 0 seconds.

  • It does not execute the task, so the run log is empty.

  • It does not block its descendant nodes, allowing them to run as scheduled.

  • It consumes no resources.

Dry-run scenarios

Several scenarios can trigger a dry-run instance.

Scenario 1: Weekly and monthly dry-runs

  • Configure a weekly or monthly node.

    1. Double-click the task node. Click the Scheduling Settings button on the right to open the scheduling properties pane. Switch to the Time Properties module.

      • Scheduling Frequency: Set to Week or Month.

      • Specified time: Set to a specific day of the week or a specific day of the month.

      • Scheduling time: Set to 10:10.

      Set Effective date to Permanent.

    2. After you complete the configuration, save and deploy the node.

  • When an auto triggered node is configured to run on a specific day of the week or a specific day of the month, it only runs and produces data at the specified time. On all other days, the system generates a dry-run instance.

To avoid dry-runs when you perform a data backfill for a scheduled node, you must set the business date correctly. For example, if a monthly node is scheduled for the 1st of each month, set the business date to the last day of the previous month for the data backfill. The same logic applies to weekly nodes.

Scenario 2: Real-time expired instances

  • Configure an expired instance to be generated in real time.

    1. Double-click the node to configure or modify its scheduling cycle. On the right, click Scheduling Settings to open the scheduling properties panel, and go to the Scheduling Time section.

      Scheduling Frequency: Set to Daily.

      Scheduling time: Set to 10:09.

    2. Save and deploy the node. The deployment time is 10:00.

  • With the Instantly generate instances after the deployment option, an auto triggered node processes data only if deployed at least 10 minutes before its scheduled time. Otherwise, it becomes a dry-run instance with the status Expired instance generated in real-time. After you save and deploy, you can verify in Operation Center that the Instance Status is Expired instance generated in real-time and the Scheduling Type is Real-time to Expired Instance Task.

Note

For more information about this feature, see Instantly generate instances after the deployment.

Scenario 3: Setting an instance to successful

If an instance fails, you can manually mark it as successful to unblock its descendant nodes. This action does not run the task or generate data. To do this, go to Operation and Maintenance Center > Auto Triggered Task O&M > Cycle Examples, find the failed instance, click More in the Actions column, and select Set to Successful. The instance's Instance Status then changes to Instance Set Successfully, with a run duration of 0s.

Scenario 4: Dry-run configuration

  • Double-click the node to open its configuration panel. On the right, click Scheduling Settings and go to the Scheduling Policies section. Manually set the Scheduling Type to Empty Run Scheduling.

  • After the configuration is complete, auto-triggered instances generated by this task show Dry-run Task as the Scheduling Type and Dry Run by Instance Properties as the Instance State in the task property details. The runtime of these instances is 0s.

Scenario 5: Unselected Instance in Temporary Workflow

  • Configure an unselected instance in a temporary workflow.

    1. Click the image icon and navigate to the All Products > Data Development and O&M > Operation and Maintenance Center (Workflow) page.

    2. In the Operation Center left navigation pane, choose Auto Triggered Task O&M > Auto Triggered Task to go to the list of auto triggered nodes.

      Find the target node, click Backfill Data in the Actions column, and select Current and Descendant Nodes from the drop-down menu.

    3. Select the auto triggered node and perform a data backfill for the current and descendant nodes to generate a temporary workflow.

      When you perform a data backfill, assume node C depends on node B, and node B depends on node A. If you backfill data for nodes A and C only, the instance for node B will have the status Unselected Instance in Temporary Workflow. After the temporary workflow is generated, open the Properties page for the corresponding backfill instance. You will see that the Instance Status is Unselected Instance in Temporary Workflow, the Instance Type is Backfill Instance, and the Task Status is Succeeded.

Scenario 6: Existing instances are not deleted after you change the scheduling cycle

This scenario applies only if instances are generated by using the Instantly generate instances after the deployment mode. When you change the scheduling cycle of a deployed node, DataWorks generates new auto triggered instances based on the latest scheduling configuration, but does not delete the instances that were already generated for the original scheduling time. For example, if you change the scheduling time of an hourly node from 10 minutes past the hour to 55 minutes past the hour, both the original-time instance and the new-time instance exist within the hour in which you make the change, so the node appears to run twice in that hour. The original-time instance is a dry-run instance because its scheduling configuration has changed, and it does not process real data.

This behavior occurs only on the day you make the change. From the next day onward, instances are generated as expected based on the latest scheduling configuration.

Dry-runs after you undeploy a node

After you undeploy a deployed node, the instances that have already been generated but have not run become dry-run instances. Their status is set to succeeded, but the node code is not executed. For more information, see Undeploy nodes.

Troubleshoot dry-runs for daily nodes

If a daily scheduled node unexpectedly runs as a dry-run, check its scheduling properties to verify whether a dry-run configuration is applied.

Note

T+1: Data generated on the current day (T) is processed on the next day (T+1).