doc-exports/docs/dataartsstudio/umn/dataartsstudio_01_0082.html

<a name="dataartsstudio_01_0082"></a><a name="dataartsstudio_01_0082"></a>

<h1 class="topictitle1">Configuring a Scheduled CDM Job</h1>
<div id="body8662426"><p id="dataartsstudio_01_0082__en-us_topic_0108275358_p8060118">CDM supports scheduled execution of table/file migration jobs by minute, hour, day, week, and month. This section describes how to configure scheduled job parameters.</p>
<div class="note" id="dataartsstudio_01_0082__en-us_topic_0108275358_note01561072235"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="dataartsstudio_01_0082__en-us_topic_0108275358_ul25860396588"><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li45861397586">When configuring scheduled jobs, do not set the same scheduled time for different jobs. Instead, set different times to avoid exceptions.</li><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li1873980191414"><p id="dataartsstudio_01_0082__en-us_topic_0108275358_p16439615131411"><a name="dataartsstudio_01_0082__en-us_topic_0108275358_li1873980191414"></a><a name="en-us_topic_0108275358_li1873980191414"></a>If you use <span id="dataartsstudio_01_0082__en-us_topic_0108275358_en-us_topic_0108275458_text63418818567">DataArts Studio</span> DataArts Factory to schedule the CDM migration job and configure this parameter, both configurations take effect. To ensure unified service logic and avoid scheduling conflicts, enable job scheduling in DataArts Factory and do not configure a scheduled task for the job in DataArts Migration.</p>
</li><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li23697610148">The scheduled execution function uses the Java Quartz timer, which is similar to the Cron expression configuration. It parses the minute, hour, day, and month of the start time, and constructs a cronb expression.<p id="dataartsstudio_01_0082__en-us_topic_0108275358_p43211424132114"><a name="dataartsstudio_01_0082__en-us_topic_0108275358_li23697610148"></a><a name="en-us_topic_0108275358_li23697610148"></a>For example, in the daily scheduling mode where the interval is set to 1 day: if the current time is 2022-10-14 12:00 and the start time is set to 2022-10-14 00:00, the job is executed at 2022-10-15 00:00; if the current time is 2022-10-14 12:00 and the start time is set to 2022-10-14 00:00, the job is executed at 2022-10-15 00:00.</p>
<p id="dataartsstudio_01_0082__en-us_topic_0108275358_p1332142462114">In the daily scheduling mode where the interval is set to 2 days: if the current time is 2022-10-14 12:00 and the start time is set to 2022-10-14 00:00, the job is executed at 2022-10-16 00:00; if the current time is 2022-10-14 12:00 and the start time is set to 2022-10-14 00:00, the job is executed at 2022-10-16 00:00.</p>
</li></ul>
</div></div>
<div class="section" id="dataartsstudio_01_0082__en-us_topic_0108275358_section5401227164326"><h4 class="sectiontitle">Scheduling Job Execution by Minute</h4><div class="p" id="dataartsstudio_01_0082__en-us_topic_0108275358_p39747982164347">CDM allows jobs to be executed every several minutes. It is recommended that the cycle be at least 5 minutes.<ul id="dataartsstudio_01_0082__en-us_topic_0108275358_ul34838058151622"><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li25976971151622"><strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b842352706143656_1">Start Time</strong>: indicates the time when the scheduled configuration takes effect, or the first time when the job is automatically executed.</li><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li41859351151647"><strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b842352706144225">Cycle (minutes)</strong>: indicates the interval when a job is executed starting from the start time.</li><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li4448755415478"><strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b842352706144238">End Time</strong>: This parameter is optional. If it is not set, the scheduled job keeps being automatically executed. If it is set, the scheduled job will be automatically stopped at the end time.</li></ul>
</div>
<div class="fignone" id="dataartsstudio_01_0082__en-us_topic_0108275358_fig45769359171517"><span class="figcap"><b>Figure 1 </b>Scheduling job execution by minute</span><br><span><img id="dataartsstudio_01_0082__en-us_topic_0108275358_image136272049244" src="en-us_image_0000002269120405.png" title="Click to enlarge" class="imgResize"></span></div>
<p id="dataartsstudio_01_0082__en-us_topic_0108275358_p11689253162515"></p>
<p id="dataartsstudio_01_0082__en-us_topic_0108275358_p14604586171724">For example, the settings shown in the above figure mean that the job will be automatically executed at 00:00 on January 1, 2023 for the first time at a cycle of 30 minutes until 23:59 on December 31, 2023.</p>
</div>
<div class="section" id="dataartsstudio_01_0082__en-us_topic_0108275358_section8879587154036"><h4 class="sectiontitle">Scheduling Job Execution by Hour</h4><div class="p" id="dataartsstudio_01_0082__en-us_topic_0108275358_p48157960154036">CDM allows jobs to be executed every several hours.<ul id="dataartsstudio_01_0082__en-us_topic_0108275358_ul8480673154036"><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li15845911154036"><strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b160078874614526">Cycle (hours)</strong>: indicates the interval when a job is automatically executed.</li><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li36775375101351"><strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b842352706145359">Trigger Time (minute)</strong>: indicates the exact time in each hour when a scheduled task is triggered. The value ranges from 0 to 59. You can set a maximum of 60 values and use commas (,) to separate these values. However, the values must be unique.<p id="dataartsstudio_01_0082__en-us_topic_0108275358_p6790200103547">If the trigger time is not within the validity period, the system selects a trigger time closest to the validity period for the scheduled job to be automatically executed at the first time. The following gives an example:</p>
<ul id="dataartsstudio_01_0082__en-us_topic_0108275358_ul4199459810369"><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li24870800103617"><span class="parmname" id="dataartsstudio_01_0082__en-us_topic_0108275358_parmname189121711115740"><b>Start Time</b></span>: <span class="parmvalue" id="dataartsstudio_01_0082__en-us_topic_0108275358_parmvalue55512574415817"><b>1:20</b></span></li><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li44276571103620"><span class="parmname" id="dataartsstudio_01_0082__en-us_topic_0108275358_parmname140936736415826"><b>Cycle (hours)</b></span>: <span class="parmvalue" id="dataartsstudio_01_0082__en-us_topic_0108275358_parmvalue55512574415845"><b>3</b></span></li><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li35183207103624"><span class="parmname" id="dataartsstudio_01_0082__en-us_topic_0108275358_parmname43058078215853"><b>Trigger Time (minute)</b></span>: <span class="parmvalue" id="dataartsstudio_01_0082__en-us_topic_0108275358_parmvalue55512574415930"><b>10</b></span></li></ul>
</li><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li60417958104419"><strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b842352706151443_1">Validity Period</strong>: includes <strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b84235270615154_1">Start Time</strong> and <strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b84235270615158_1">End Time</strong>.<ul id="dataartsstudio_01_0082__en-us_topic_0108275358_ul6395004104435"><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li21092174104439"><strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b842352706151515_1">Start Time</strong>: indicates the time when the scheduled configuration takes effect.</li><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li8395472154036"><strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b842352706151528_1">End Time</strong>: This parameter is optional, which indicates the time when the scheduled job is automatically stopped. If this parameter is not set, the scheduled job keeps being automatically executed.</li></ul>
</li></ul>
</div>
<div class="fignone" id="dataartsstudio_01_0082__en-us_topic_0108275358_fig8450385154036"><span class="figcap"><b>Figure 2 </b>Scheduling job execution by hour</span><br><span><img id="dataartsstudio_01_0082__en-us_topic_0108275358_image69491617193718" src="en-us_image_0000002234241012.png" title="Click to enlarge" class="imgResize"></span></div>
<p id="dataartsstudio_01_0082__en-us_topic_0108275358_p20993203402712"></p>
<p id="dataartsstudio_01_0082__en-us_topic_0108275358_p53424247154036">For example, the settings shown in the above figure mean that the job will be automatically executed at 00:10 on January 1, 2023 for the first time, at 00:30 for the second time, and at 00:50 for the third time. It will be executed three times every two hours until 23:59 on December 31, 2023.</p>
</div>
<div class="section" id="dataartsstudio_01_0082__en-us_topic_0108275358_section711860216272"><h4 class="sectiontitle">Scheduling Job Execution by Day</h4><div class="p" id="dataartsstudio_01_0082__en-us_topic_0108275358_p3973586616272">CDM allows jobs to be executed every several days.<ul id="dataartsstudio_01_0082__en-us_topic_0108275358_ul6448858716272"><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li5619306016272"><strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b1713170225">Cycle (days)</strong>: indicates the interval when a job is executed starting from the start time.</li><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li5446713211857"><strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b842352706151443_3">Validity Period</strong>: includes <strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b84235270615154_3">Start Time</strong> and <strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b84235270615158_3">End Time</strong>.<ul id="dataartsstudio_01_0082__en-us_topic_0108275358_ul2044214311857"><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li4976156711857"><strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b842352706143656_3">Start Time</strong>: indicates the time when the scheduled configuration takes effect, or the first time when the job is automatically executed.</li><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li4520092411857"><strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b842352706151528_3">End Time</strong>: This parameter is optional, which indicates the time when the scheduled job is automatically stopped. If this parameter is not set, the scheduled job keeps being automatically executed.</li></ul>
</li></ul>
</div>
<div class="fignone" id="dataartsstudio_01_0082__en-us_topic_0108275358_fig5534404616272"><span class="figcap"><b>Figure 3 </b>Scheduling job execution by day</span><br><span><img id="dataartsstudio_01_0082__en-us_topic_0108275358_image126591194382" src="en-us_image_0000002234241072.png" title="Click to enlarge" class="imgResize"></span></div>
<p id="dataartsstudio_01_0082__en-us_topic_0108275358_p42417542916"></p>
<p id="dataartsstudio_01_0082__en-us_topic_0108275358_p1338287516272">For example, the settings shown in the above figure mean that the job will be automatically executed at 00:00 on January 1, 2023 for the first time, and will be executed once every three days. The configuration is valid permanently.</p>
</div>
<div class="section" id="dataartsstudio_01_0082__en-us_topic_0108275358_section44039195105044"><h4 class="sectiontitle">Scheduling Job Execution by Week</h4><div class="p" id="dataartsstudio_01_0082__en-us_topic_0108275358_p37410378112039">CDM allows jobs to be executed every several weeks.<ul id="dataartsstudio_01_0082__en-us_topic_0108275358_ul10341809112039"><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li32380163112039"><strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b842352706155015">Cycle (weeks)</strong>: indicates the interval when a scheduled job is executed starting from the start time.</li><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li16281869112257"><strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b842352706155042">Trigger Time (day)</strong>: You can specify the day of each week when the job is automatically executed. One or more days can be selected at a time.</li><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li22986017112039"><strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b842352706151443_5">Validity Period</strong>: includes <strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b84235270615154_5">Start Time</strong> and <strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b84235270615158_5">End Time</strong>.<ul id="dataartsstudio_01_0082__en-us_topic_0108275358_ul65526389112634"><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li25967417112039"><strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b842352706151515_3">Start Time</strong>: indicates the time when the scheduled configuration takes effect.</li><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li32098161112736"><strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b842352706151528_5">End Time</strong>: This parameter is optional, which indicates the time when the scheduled job is automatically stopped. If this parameter is not set, the scheduled job keeps being automatically executed.</li></ul>
</li></ul>
</div>
<div class="fignone" id="dataartsstudio_01_0082__en-us_topic_0108275358_fig5547562112039"><span class="figcap"><b>Figure 4 </b>Scheduling job execution by week</span><br><span><img id="dataartsstudio_01_0082__en-us_topic_0108275358_image230415515382" src="en-us_image_0000002234241004.png" title="Click to enlarge" class="imgResize"></span></div>
<p id="dataartsstudio_01_0082__en-us_topic_0108275358_p3524175022914"></p>
<p id="dataartsstudio_01_0082__en-us_topic_0108275358_p17641474112039">For example, the settings shown in the above figure mean that the job will be automatically executed at 00:00 every Tuesday, Saturday, and Sunday every two weeks starting from 00:00 on January 1, 2023 until 23:59 on December 31, 2023.</p>
</div>
<div class="section" id="dataartsstudio_01_0082__en-us_topic_0108275358_section3099373164026"><h4 class="sectiontitle">Scheduling Job Execution by Month</h4><div class="p" id="dataartsstudio_01_0082__en-us_topic_0108275358_p49722659164026">CDM allows jobs to be executed every several months.<ul id="dataartsstudio_01_0082__en-us_topic_0108275358_ul1003549164026"><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li14178627164026"><strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b117620684815599">Cycle (months)</strong>: indicates the interval when a scheduled job is executed starting from the start time.</li><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li7247093113825"><strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b6933588251604">Trigger Time (day)</strong>: indicates the day of each month when the job is executed. The value ranges from 1 to 31. You can set multiple values and use commas (,) to separate these values. However, the values must be unique.</li><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li15468555114124"><strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b842352706151443_7">Validity Period</strong>: includes <strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b84235270615154_7">Start Time</strong> and <strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b84235270615158_7">End Time</strong>.<ul id="dataartsstudio_01_0082__en-us_topic_0108275358_ul44098120114157"><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li9031943164026"><strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b842352706151515_5">Start Time</strong>: indicates the time when the scheduled configuration takes effect. The automatic execution time is accurate to hour, minute, and second.</li><li id="dataartsstudio_01_0082__en-us_topic_0108275358_li60498787164026"><strong id="dataartsstudio_01_0082__en-us_topic_0108275358_b842352706151528_7">End Time</strong>: This parameter is optional, which indicates the time when the scheduled job is automatically stopped. If this parameter is not set, the scheduled job keeps being automatically executed.</li></ul>
</li></ul>
</div>
<div class="fignone" id="dataartsstudio_01_0082__en-us_topic_0108275358_fig7618175164026"><span class="figcap"><b>Figure 5 </b>Scheduling job execution by month</span><br><span><img id="dataartsstudio_01_0082__en-us_topic_0108275358_image23291943183913" src="en-us_image_0000002234081196.png" title="Click to enlarge" class="imgResize"></span></div>
<p id="dataartsstudio_01_0082__en-us_topic_0108275358_p7728114618306"></p>
<p id="dataartsstudio_01_0082__en-us_topic_0108275358_p50722796164026">For example, the settings shown in the above figure mean that the job will be automatically executed at 00:00 on the 5th and 25th days of each month starting from 00:00 on January 1, 2023 until 23:59 on December 31, 2023.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dataartsstudio_01_0081.html">Creating a Job in a CDM Cluster</a></div>
</div>
</div>


<script language="JavaScript">
<!--
initImageViewer('.imgResize');
var msg_imageMax = "view original image";
var msg_imageClose = "close";
//--></script>