All Products
Search
Document Center

DataWorks:Schedule a node by week

Last Updated:Jan 19, 2024

If a node is scheduled by week, the node is automatically run at a specified point in time on specific days every week. For example, a node is scheduled to run at 00:00 on Monday and Tuesday every week.

Precautions

  • To ensure that the descendant nodes of an auto triggered node that is scheduled by week can run as expected at a point in time that is not the scheduling time of the node, the system generates a dry-run instance for the node.

    Important

    If a node is dry run, the system does not actually run the node but directly prompts that the node is successfully run.

    • The running duration of the node is 0 second, and no run logs are generated for the node.

    • The node does not occupy scheduling resources.

    • The node does not block the running of its descendant nodes that are scheduled by minute, hour, or day.

  • You can configure a scheduling frequency only for a single node. Whether a node is scheduled to run every day depends on the scheduling frequency configured for the node and is unrelated to the scheduling frequencies of the ancestor nodes of the node. The scheduling time of the ancestor nodes of the node affects the actual time when the node is run.

Configuration example

  • Configuration method

    On the DataStudio page, create a node and go to the configuration tab of the node. Click the Properties tab in the right-side navigation pane. In the General section of the Properties tab, configure the scheduling period for the node.

  • Scenario

    • Configuration details

      If the node is scheduled to run at a specified point in time every Monday and Friday, the scheduling system runs the instances that are generated for the node every Monday and Friday. The scheduling system does not run the instances that are generated for the node every Tuesday, Wednesday, Thursday, Saturday, or Sunday and directly returns a success response for the instances. The following figure shows the details about the configurations.

      Note The cron expression is automatically generated based on the scheduling time that you select and cannot be changed.

      周调度

    • Scheduling details

      The scheduling system automatically generates and runs instances for the node.周调度场景

      Important

      If you use the data backfill feature provided in Operation Center to backfill data for a node that is scheduled by week, you must make sure that the data timestamp you specify is one day before the date on which the node is scheduled to run in the current scheduling cycle. The data timestamp of a node is calculated based on the following formula: Date of the scheduling time of the node - 1.

      Description:

      • If you want to backfill data for a node that is scheduled to run every Monday, you must set the data timestamp to the date of last Sunday for the node.

      • If you set the data timestamp to a date that is not the date of last Sunday, the data backfill instance generated for the node will be dry run.