Configure scheduling calendars
Custom scheduling calendars let you define flexible scheduling dates and methods for your tasks. You can create calendars that include only specific dates, such as trading days, and apply them across workspaces.
Background
Custom scheduling calendars are ideal for industries and scenarios that require flexible scheduling dates, such as:
-
In the financial industry, tasks must avoid running during market closures such as public holidays and weekends. You can create an annual calendar that includes only trading days, so developers can select valid run dates without manually excluding non-trading days.
-
You can combine a custom calendar with hourly scheduling to run tasks only on specific days. For example, define a calendar where tasks run normally on Monday, Tuesday, and Wednesday but perform a dry run on other days, then select that calendar in the task's scheduling configuration.
Limitations
-
Only an Alibaba Cloud account, a tenant administrator, or a RAM user with the AliyunDataWorksFullAccess permission can create scheduling calendars. For more information about how to grant permissions, see Add members to a workspace.
-
This feature is available only in DataWorks Enterprise Edition.
-
Each tenant can have up to 10 scheduling calendars.
Navigate to the scheduling calendar configuration page
Log on to the DataWorks console. In the target region, click in the left-side navigation pane. Select a workspace from the drop-down list and click Go to Operation Center.
-
Navigate to the scheduling calendar configuration page.
In the left-side navigation pane of the Operation Center, click Scheduling Configuration to open the Scheduling Calendars page.
Create a scheduling calendar
On the Scheduling Calendar Management page, click Create Scheduling Calendar. In the panel that appears, configure the following parameters and then click Submit.
-
Basic parameters
Parameter
Description
Name
The name of the scheduling calendar. Must be unique within the tenant.
Owner
The owner of the scheduling calendar.
Applicable Workspace
The workspaces where this calendar can be used. You can apply it to all workspaces or only to specific ones.
Calendar Constraints
Select a constraint type to control whether the calendar requires a validity period.
-
Strong constraint: Requires a validity period. Every date within this period must be explicitly set as a scheduling day or a non-scheduling day. The system sends reminders before the validity period expires.
-
Weak constraint: Does not require a validity period. You only need to define the scheduling days.
-
-
Calendar constraint configuration
Strong constraint
Parameter
Description
Validity Period
The date range for the calendar. In the Configuration of Scheduling Days section, you must configure every date within this range for either normal scheduling or a dry run.
Expiration Notification
Configure expiration reminders. When enabled, the platform sends an SMS reminder to the calendar owner at
9:30. If no action is taken, a reminder phone call is made on the last day of the validity period. The calendar is automatically disabled after expiration.Node Running Policy for Calendar Expiration
How tasks that use this calendar are scheduled after its validity period expires.
Configuration of Scheduling Days
Click dates on the calendar to define the scheduling behavior for each date. The configuration options differ for strong and weak constraints. Follow the on-screen instructions.
Weak constraint
Parameter
Description
Policy for Node Running on Unconfigured Dates
The scheduling behavior for dates that are not explicitly set as scheduling days in the Configuration of Scheduling Days section.
Configuration of Scheduling Days
Click dates on the calendar to define the scheduling behavior for each date. The configuration options differ for strong and weak constraints. Follow the on-screen instructions.
Use a scheduling calendar
In an authorized workspace, navigate to the section of a node. Change the calendar setting to Custom and select the desired calendar. The node is then scheduled based on the rules defined in that calendar.
A custom scheduling calendar takes effect only when the node's scheduling type is set to Normally Scheduled.
-
If the scheduling type is Normally Scheduled, the node's scheduling behavior follows the policy in the custom scheduling calendar.
-
If the scheduling type is Pause scheduling or Empty Run Scheduling, the node's scheduling type determines its scheduling behavior, overriding the custom calendar.
View reference tasks
In the scheduling calendar list, click View Reference Tasks for a calendar to see which workspaces and tasks are using it.