Some tasks can't follow a fixed daily or weekly cadence — for example, financial pipelines that must skip market holidays, or hourly jobs that should only run on specific days of the week. Scheduling calendars let you define custom scheduling dates at the tenant level. After you create a calendar, you can apply it to any task node to override the default scheduling behavior.
Use cases
Financial industry: Exclude statutory holidays and weekends when markets are closed. Configure an annual calendar with only trading days as scheduling days, then apply it to downstream pipeline tasks.
Day-of-week restrictions: Run a task hourly, but only on specific days of the week. For example, mark Monday, Tuesday, and Wednesday as scheduling days and treat the remaining days as non-scheduling days.
Prerequisites
Before you begin, ensure that you have:
A DataWorks Enterprise Edition workspace (scheduling calendars are not available in other editions)
An Alibaba Cloud account, tenant administrator privileges, or a RAM user with the AliyunDataWorksFullAccess policy
A maximum of 10 scheduling calendars can be created per tenant.
Choose a constraint type
Every scheduling calendar uses one of two constraint types. Choose based on your scenario before you start configuring.
| Strong constraint | Weak constraint | |
|---|---|---|
| Validity period required | Yes — specify a start and end date | No |
| Scheduling day configuration | Every date within the validity period must be marked as a scheduling day or non-scheduling day | Specify only scheduling days; unspecified dates follow the No Processing Policy Set |
| Expiration handling | Configure Expiration Reminder and Overtime Processing Policy | Not applicable |
| Best for | Scenarios with a defined end date (e.g., annual fiscal calendar) | Open-ended or recurring day-of-week patterns |
Financial industry scenario → Use a strong constraint. You know the full trading calendar for the year, so set a validity period and mark each date explicitly.
Day-of-week scenario → Use a weak constraint. Mark the target weekdays as scheduling days and leave the policy for unspecified dates.
Create a scheduling calendar
Log on to the DataWorks console. In the top navigation bar, select the target region.
In the left-side navigation pane, choose Data Development and O&M > Operation Center. Select the target workspace and click Go to Operation Center.
In the left-side navigation pane of Operation Center, click Tenant Schedule Setting to open the Schedule Calendar Management page.
Click New Schedule Calendar.
In the New Schedule Calendar panel, configure the basic parameters:
Parameter Description Name A unique name within the current tenant Responsible Person The owner of the scheduling calendar Applicable Work Space Select Applicable to all workspaces or choose specific workspaces. Only tasks in the selected workspaces can use this calendar. Calendar Constraints Select Strong or Weak. See Choose a constraint type. Configure the constraint-specific parameters based on your selection.
Strong constraint parameters
Parameter Description Calendar Validity Period The date range for the calendar. Every date within this range must be marked as a scheduling day or non-scheduling day in Scheduling Day Configuration. Expiration Reminder The period before expiration during which the system sends a daily text message to the owner at 9:30. If the validity period is not extended by the day before expiration, the system also initiates a phone call to the owner on the expiration date. Overtime Processing Policy How tasks scheduled by this calendar are handled after the validity period ends. Scheduling Day Configuration The scheduling method for each date within the validity period. Weak constraint parameters
Parameter Description No Processing Policy Set How tasks are handled on dates not marked as scheduling days. Scheduling Day Configuration The scheduling method for each date you designate as a scheduling day. Click Submission.
Apply a scheduling calendar to a task
Open the task node in Data Studio and go to the Properties tab.
In the Schedule section, set Scheduling Calendar to Customize Calendar, then select the scheduling calendar from the drop-down list.
The scheduling calendar only takes effect when the task's scheduling type is normal scheduling.
Normal scheduling — the task runs based on the dates defined in the scheduling calendar.
Scheduling pause or dry run — the task ignores the calendar and runs based on the Recurrence parameter instead.
View workspaces and tasks that reference a scheduling calendar
On the Schedule Calendar Management page, find the scheduling calendar and click View Reference Tasks in the Operation column to see all workspaces and tasks using it.