Offline Task Scheduling Property Configuration

更新时间: 2026-06-23 12:20:35

Scheduling properties define how a node runs on a recurring basis in the production environment, including the scheduling cycle, effective dates, and other parameters.

Procedure

  1. On the Dataphin homepage, in the top menu bar, select Development > Data Development.

  2. On the Development page, in the top menu bar, select Project.

  3. In the left navigation pane, select Data Processing > Compute Task, and in the Compute Task list, click the name of the target task.

  4. On the task tab, click Property on the right to open the Property panel.

  5. In the offline integration task Property panel, configure the parameters in the Scheduling Properties section.

    Parameter

    Description

    Configuration Method

    Select either Custom Configuration or Scheduling Template.

    If you select Scheduling Template, you can choose from all basic scheduling templates configured under Planning > Common Business Logic > Offline Scheduling Templates. If no suitable template exists, click Create Scheduling Template to create one. After selecting a template, the parameters Schedule Type, Effective Date, and Recurrence become read-only. You can still configure Priority, Rerun Properties, and Conditional Scheduling.

    Schedule Type

    Supported schedule types: Normal, Dry-run, and Skip Execution.

    • Normal: The task runs on its scheduling cycle and executes real data processing. This is the default for most tasks.

    • Dry-run: The task is scheduled on its cycle but does not process real data. When triggered, it immediately returns success without execution. Use this type when a node should not run for a period but must not block its downstream nodes.

    • Skip Execution: The task is scheduled per its cycle, but its status is marked as paused. When triggered, the system returns failure and blocks all dependent downstream nodes. Use this when a task is temporarily inactive but will be used again later.

    Priority

    Set the task priority. Options: Medium, Low, or Lowest.

    For new offline tasks, the default priority is configured in Management Hub > Development Platform Settings > Node Task Settings.

    Note

    After the task is published to production or submitted in the Basic environment, its priority cannot be edited here. Modify it in production O&M instead. The displayed value reflects the latest production priority.

    Effective Date

    The task runs automatically only within the effective date range. Outside this range, the task is not scheduled.

    Scheduling Time Zone

    Shows the time zone configured in Management Hub > System Settings > Basic Settings. Instance generation, scheduling cycles, and effective dates are calculated based on this time zone.

    Recurrence

    The recurrence defines how often the task runs in the production scheduling system. After submission, the system generates recurring instances starting the next day based on the configured time attributes. Instances run according to upstream dependencies and timing.

    Choose from the following recurrence options: Daily, Weekly, Monthly, Hourly, and Minute:

    • Daily: The task runs once every day. By default, new recurring tasks run at 00:00 daily. Click the image icon to specify a different time.

    • Weekly: The task runs once per week on selected days at a specified time. Click the image icon to set the time.

      Note

      On non-scheduled days, the system creates an instance and marks it as successful without executing logic or consuming resources. This ensures downstream instances run normally.

    • Monthly: The task runs once per month on selected days at a specified time. Click the image icon to set the time.

      Note

      On non-scheduled days, the system creates a daily instance and marks it as successful without executing logic or consuming resources. This ensures downstream instances run normally.

    • Hourly: Supports Time Frame, On the Hour, Custom Time Frame, and Custom Time Point scheduling.

      • Time Frame: The task runs at regular intervals within a specified daily time window. Click the image icon to set the Start Time and End Time. Click the image icon to select Every n Hours. For example, if the time frame is 00:00–23:00 with a 1-hour interval, the task runs hourly throughout the day.

      • On-the-hour scheduling: Select an On The Hour time from the drop-down list. The system generates an instance and runs it at the selected time.

      • Custom Time Point: The system generates and runs instances at specified custom times. Select times from the drop-down list, and click + Add Custom Time Point to add more.

      • Custom Time Frame: The task runs at regular intervals within custom daily time windows. Click the image icon to set Start Time and End Time. Enter an interval of Every n Minutes (n must be an integer from 5 to 360). Click + Add Custom Time Frame to add up to 10 non-overlapping time frames. For example, with a time frame of 00:00–03:00 and a 30-minute interval, the task runs every 30 minutes during that window.

    • Minute-level scheduling: Supports Daily or Hourly schedules.

      • Daily: The task runs at fixed intervals within a specified daily time window.

      • Hourly: The task runs at fixed intervals from a specified start minute until the end of each hour.

    Scheduling Run Plan

    Click Preview to view all scheduled instances for a given month based on your recurrence and conditional scheduling settings. You can preview by Data Timestamp or Runtime (Scheduled Date).

    If multiple schedule types occur on the same day, the calendar uses color coding with a count for each type. For example, the following image shows that on the 4th of a month, the task has 44 normal instances, 2 skipped instances, and 12 dry-run instances.image

    Hover over a day’s schedule block to see a detailed list of instances, including runtime (based on the scheduling time zone), schedule type, and condition name.

    Conditional Scheduling

    After enabling conditional scheduling, select a Configuration Method: Custom Settings or Scheduling Template.

    Important
    • You can define up to 10 scheduling conditions. The system evaluates them top to bottom. When a condition matches, the corresponding action runs, and evaluation stops. If no condition matches, the default scheduling configuration applies.

    • Conditional scheduling works only when the schedule type is Normal.

    • All conditions and start times use the configured scheduling time zone. At instance generation, the system checks whether the instance matches any condition to determine its schedule type.

    • Custom Settings

      1. Click + Add Scheduling Condition.

      2. In the Edit Conditional Scheduling dialog box, configure the following:

        • Condition Name: Any characters allowed, up to 32 characters long.

        • Status: Enabled by default. When disabled, the condition is ignored during scheduling.

        • When the following condition is met: The rule used to evaluate the condition. If true, the task runs according to the Schedule Action settings. For details, see Conditional Scheduling Rule Description.

        • Schedule Action: Choose between Custom and Follow Scheduling Properties:

          • Custom: If the condition is met, run the task using the specified Schedule Type.

          • Follow Scheduling Properties: Use the same schedule type defined in the main scheduling properties—equivalent to disabling conditional scheduling.

        • Scheduling Type: For more information, see Scheduling Type.

      3. Click OK.

        After configuring conditional scheduling, click Preview Scheduling Run Plan to see which dates match your conditions on the calendar.

        Important
        • After modifying conditional scheduling settings and publishing to production, changes apply immediately to instances that are not yet running but do not affect instances already in waiting-to-run status.

        • If your condition uses cross-node parameter evaluation, provide possible parameter values for accurate preview.

    • Scheduling Template

      Select a conditional scheduling template from Planning > Common Business Logic > Offline Scheduling Templates. If none fit, click Create Scheduling Template to create one. After selection, you cannot add new conditions. Click the View Details icon next to any condition to see its full configuration.

      Note

      If the task’s recurrence is Daily, Weekly, or Monthly, the Start Time parameter in the referenced conditional scheduling template takes effect. If the recurrence is Hourly or Minute, the Start Time parameter is ignored.

  6. Click OK to complete the offline task scheduling property configuration.

上一篇: Configure offline task running resources 下一篇: Configure scheduling dependencies for offline tasks
阿里云首页 智能数据建设与治理 Dataphin 相关技术圈