yexinru/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
Files
0b3a43371a4bcc99577594de0a685249d676a567
doc-exports/docs/dli/api-ref/dli_02_0228.html
Su, Xiaomeng 04ae6632a7 dli_api_20250929 
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Co-authored-by: Su, Xiaomeng <suxiaomeng1@huawei.com>
Co-committed-by: Su, Xiaomeng <suxiaomeng1@huawei.com>
2026-01-19 08:09:55 +00:00

640 lines
54 KiB
HTML
Raw Blame History

<a name="dli_02_0228"></a><a name="dli_02_0228"></a>
<h1 class="topictitle1">Creating a SQL Job</h1>
<div id="body1574749523870"><div class="section" id="dli_02_0228__s89ff8bc59cba4c3b94dc17e85c8fa1ea"><h4 class="sectiontitle">Function</h4><p id="dli_02_0228__a4deaa8ebc392424e869c47835399ab23">This API is used to create a Flink streaming SQL job.</p>
</div>
<div class="section" id="dli_02_0228__sef21e3efc2a44a84a03adad33a1ae006"><h4 class="sectiontitle">URI</h4><ul id="dli_02_0228__uf99c5b2f64a44669a611cae56296b336"><li id="dli_02_0228__l02802a572cd14322a9edb44c392d1063">URI format<p id="dli_02_0228__ab9f59a1049d24cb2a9c51b9ed06e59d4"><a name="dli_02_0228__l02802a572cd14322a9edb44c392d1063"></a><a name="l02802a572cd14322a9edb44c392d1063"></a>POST /v1.0/{project_id}/streaming/sql-jobs</p>
</li><li id="dli_02_0228__lab001edff5ca4cde843db03812f0979d">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0228__t219b031199884ac1bb9e91158ddc9efb" frame="border" border="1" rules="all"><caption><b>Table 1 </b>URI parameter</caption><thead align="left"><tr id="dli_02_0228__r04005eeda24e4db9b06516450d4d56af"><th align="left" class="cellrowborder" valign="top" width="15.690000000000001%" id="mcps1.3.2.2.2.1.2.5.1.1"><p id="dli_02_0228__a80847df5e5dc448caa46a2ff258fa2c4">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="12.97%" id="mcps1.3.2.2.2.1.2.5.1.2"><p id="dli_02_0228__af54fc16087b049c98f748c1a2faace17">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="11.14%" id="mcps1.3.2.2.2.1.2.5.1.3"><p id="dli_02_0228__p468716366114">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60.199999999999996%" id="mcps1.3.2.2.2.1.2.5.1.4"><p id="dli_02_0228__a484a3e0ce14846799c727ccbd4075d6c">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0228__r8022e11be3f54ad290cf8c848a56a550"><td class="cellrowborder" valign="top" width="15.690000000000001%" headers="mcps1.3.2.2.2.1.2.5.1.1 "><p id="dli_02_0228__a2b526eb27eb241248b0586fd54086598">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="12.97%" headers="mcps1.3.2.2.2.1.2.5.1.2 "><p id="dli_02_0228__p1016041415356">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="11.14%" headers="mcps1.3.2.2.2.1.2.5.1.3 "><p id="dli_02_0228__p1268773616112">String</p>
</td>
<td class="cellrowborder" valign="top" width="60.199999999999996%" headers="mcps1.3.2.2.2.1.2.5.1.4 "><p id="dli_02_0228__p185631315510">Project ID, which is used for resource isolation. For details about how to obtain a project ID, see <a href="dli_02_0183.html">Obtaining a Project ID</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="dli_02_0228__s3afece1037ea4f62aeffb3db49b97f70"><h4 class="sectiontitle">Request Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0228__tcedd9d5bece544898da42c15fe855a72" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request parameters</caption><thead align="left"><tr id="dli_02_0228__r263212cfc24b4f7ab11ba179dc95f8d5"><th align="left" class="cellrowborder" valign="top" width="20.84%" id="mcps1.3.3.2.2.5.1.1"><p id="dli_02_0228__aa71bb56aa6ba48488d66e68a44744488">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="12.13%" id="mcps1.3.3.2.2.5.1.2"><p id="dli_02_0228__adfb457c202dc4709b315aa6d0a384fdf">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="11.63%" id="mcps1.3.3.2.2.5.1.3"><p id="dli_02_0228__a07ad11538b854ab4997a0c69b2fa1ff5">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="55.400000000000006%" id="mcps1.3.3.2.2.5.1.4"><p id="dli_02_0228__a27603242143846be8ed4173686b0b27b">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0228__rab514ea502754f9d88a6ca5cd27e6f9b"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p24236235151446">name</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__a3f01c30693ef41f9ab8913a733a8dcae">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__a4c806296e81547638d0ed294d9a3ca63">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__ace897a9e7d9d47a1895664dd49e10fe5">Name of the job. The value can contain 1 to 57 characters.</p>
</td>
</tr>
<tr id="dli_02_0228__rd59ae95756ea47c28d7aa24b2a057881"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p60911214151446">desc</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__a3db6910eff34455caa5af7c1be07ff39">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__a3b4b1f2ddd81469dbc22dc9de316fc9b">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__a4de8fb2d168546a9adf40df6d59ce095">Job description. Length range: 0 to 512 characters.</p>
</td>
</tr>
<tr id="dli_02_0228__rc32461e6ae584faebd86e6a27d35ad52"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p45216947151446">template_id</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__aa5ebc166527543019d7799ddf643663f">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__ad6a32cc0ba694cea9fe5f132dd482a0b">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__a6311275524c844f4aa133f8f5818d0c0">Template ID.</p>
<p id="dli_02_0228__p1438412141206">If both <strong id="dli_02_0228__b84235270617632">template_id</strong> and <strong id="dli_02_0228__b84235270617635">sql_body</strong> are specified, <strong id="dli_02_0228__b84235270617645">sql_body</strong> is used. If <strong id="dli_02_0228__b7366586515825">template_id</strong> is specified but <strong id="dli_02_0228__b189050023915825">sql_body</strong> is not, fill <strong id="dli_02_0228__b197376495515825">sql_body</strong> with the <strong id="dli_02_0228__b3805696915825">template_id</strong> value.</p>
</td>
</tr>
<tr id="dli_02_0228__row71872872118"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p17928153443914">queue_name</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p89278346396">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p1292519344391">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p18919434113920">Name of a queue. The value can contain 0 to 128 characters.</p>
</td>
</tr>
<tr id="dli_02_0228__r38ed7748501049b3a7f15541cb4bdc4b"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p30775898151446">sql_body</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__a340bf6a8cdce459ebdb06f53dd44204d">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__ab0cf8c891059456883c2149d7b794ba1">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__ac9cd898aa62e4b4c81ae3645e8d767e0">Stream SQL statement, which includes at least the following three parts: source, query, and sink. Length range: 1,024 x 1,024 characters.</p>
</td>
</tr>
<tr id="dli_02_0228__r6d6edee93eb44b018bb642182c0e6228"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p51971590151446">run_mode</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__aba11f8fa96ff477e8af2e81aabc0d8de">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__a1c9f0e6238ad4ce69be9eafbb38d73d9">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p79611213113">Job running mode. The options are as follows:</p>
<ul id="dli_02_0228__ul15289751193715"><li id="dli_02_0228__li109014434020"><strong id="dli_02_0228__b176881152382">shared_cluster</strong>: indicates that the job is running on a shared cluster.</li><li id="dli_02_0228__li10403410212"><strong id="dli_02_0228__b198194161388">exclusive_cluster</strong>: indicates that the job is running on an exclusive cluster.</li><li id="dli_02_0228__li228914518371"><strong id="dli_02_0228__b2098915178386">edge_node</strong>: indicates that the job is running on an edge node.</li></ul>
<p id="dli_02_0228__p19772114195416">The default value is <strong id="dli_02_0228__b182112035112512">shared_cluster</strong>.</p>
</td>
</tr>
<tr id="dli_02_0228__r7661b89ca2e94401ab63183ad079e920"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p19885945151446">cu_number</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__a4b43c1e99deb4082b3f21179c1477b1f">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__adf45245d5ce04f61afc160b115d2412b">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__a37e9360fa1d44cf0b3fafc4bbe29cc2d">Number of CUs selected for a job. The default value is <strong id="dli_02_0228__b1068913171848">2</strong>.</p>
<p id="dli_02_0228__p103554498466">Sum of the number of compute units and job manager CUs of DLI. CU is also the billing unit of DLI. One CU equals one vCPU and 4 GB of memory. The value is the number of CUs required for job running and cannot exceed the number of CUs in the bound queue. For details about how to set the number of CUs of JobManager, see <strong id="dli_02_0228__b177365311593">manager_cu_number</strong>.</p>
</td>
</tr>
<tr id="dli_02_0228__r589617809d1e42868f5a1aa6a3dbf196"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p19578767151446">parallel_number</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__a3081bb162d8a41cda78080611d26e443">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__a714864b01e3b4f948edf105756d06630">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__a5c667b50c56f47dbb9bee32c10d72ba0">Number of parallel jobs set by a user. The default value is <strong id="dli_02_0228__b84235270615612">1</strong>.</p>
<p id="dli_02_0228__p1921120114817">Number of Flink SQL jobs that run at the same time. Properly increasing the number of parallel threads improves the overall computing capability of the job. However, the switchover overhead caused by the increase of threads must be considered. This value cannot be greater than four times the compute units (number of CUs minus the number of JobManager CUs).</p>
<p id="dli_02_0228__p24101740145118">For details about how to set the number of JobManager CUs, see <strong id="dli_02_0228__b2344162814219">manager_cu_number</strong>.</p>
</td>
</tr>
<tr id="dli_02_0228__r4751eede45fe4cb3856249640bbc3c77"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p686005151439">checkpoint_enabled</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__a582fb4ae115d44e79559c249bfcafab6">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__a32e117ff1f8940e79eb14e009be0e7ab">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p4191338101210">Whether to enable the automatic job snapshot function.</p>
<ul id="dli_02_0228__ul960951941319"><li id="dli_02_0228__li1960812195138"><strong id="dli_02_0228__b978532443113958">true</strong>: indicates to enable the automatic job snapshot function.</li><li id="dli_02_0228__li1660811981313"><strong id="dli_02_0228__b211827064711404">false</strong>: indicates to disable the automatic job snapshot function.</li><li id="dli_02_0228__li1460951901319">Default value: <strong id="dli_02_0228__b75463629211402">false</strong></li></ul>
</td>
</tr>
<tr id="dli_02_0228__rbef8b00389c343f1a6acb6261756d967"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p32848831151439">checkpoint_mode</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__ac3897cc29eb1495b9bbee471c304e326">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__af4e810f37b724bb4860e63e51fc32e05">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p228619524239">Snapshot mode. Options:</p>
<ul id="dli_02_0228__ul133371056182314"><li id="dli_02_0228__li13961658142316"><strong id="dli_02_0228__b55631957131812">1</strong>: <strong id="dli_02_0228__b856995719181">ExactlyOnce</strong>, indicates that data is processed only once.</li><li id="dli_02_0228__li1433713569235"><strong id="dli_02_0228__b103863119198">2</strong>: <strong id="dli_02_0228__b03861161912">AtLeastOnce</strong>, indicates that data is processed at least once.</li></ul>
<p id="dli_02_0228__p1972956121218">The default value is <strong id="dli_02_0228__b1079595121910">1</strong>.</p>
</td>
</tr>
<tr id="dli_02_0228__row14878123920261"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p13880183918268">checkpoint_interval</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p186384642711">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p1664216614270">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p5880113952617">Snapshot interval. The unit is second. The default value is <span class="parmvalue" id="dli_02_0228__parmvalue12310144416509"><b>10</b></span>.</p>
</td>
</tr>
<tr id="dli_02_0228__rbdbc4a1a7b9d41b0873a21b5c8c515a4"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p32635548151439">obs_bucket</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__af1ba5522fd1e4cb1856c94e5e69a665d">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__a9a24d2aea7e342e2891e5daf0bf14743">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__a1ce1860d24414e2081b94e41c906d4f7">OBS bucket where users are authorized to save the snapshot. This parameter is valid only when <span class="parmname" id="dli_02_0228__parmname98580381216"><b>checkpoint_enabled</b></span> is set to <strong id="dli_02_0228__b34793150017352">true</strong>.</p>
<p id="dli_02_0228__p18511124216591">OBS bucket where users are authorized to save the snapshot. This parameter is valid only when <strong id="dli_02_0228__b440203212813">log_enabled</strong> is set to <strong id="dli_02_0228__b114108325286">true</strong>.</p>
</td>
</tr>
<tr id="dli_02_0228__r7c856f9629304e7bb100c8794d29caf1"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p29331592151433">log_enabled</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__a01071703297a4354bb6cb18ba6572f3f">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__a279c155d38614fc486c897f82f6a3a8f">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__a8819ccc464094137afa687b48d8f62b2">Whether to enable the function of uploading job logs to users' OBS buckets. The default value is <span class="parmvalue" id="dli_02_0228__parmvalue18333947602"><b>false</b></span>.</p>
</td>
</tr>
<tr id="dli_02_0228__row1973917493203"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p27391449182012">smn_topic</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p1773919491205">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p147398499204">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p67391449142016">SMN topic. If a job fails, the system will send a message to users subscribed to the SMN topic.</p>
</td>
</tr>
<tr id="dli_02_0228__row014411362057"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p12884615665">restart_when_exception</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p1414410363514">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p1714403618511">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p314419367515">Whether to enable the function of automatically restarting a job upon job exceptions. The default value is <span class="parmvalue" id="dli_02_0228__parmvalue52961551300"><b>false</b></span>.</p>
</td>
</tr>
<tr id="dli_02_0228__row71935566513"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p1888312819610">idle_state_retention</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p21931256755">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p1119385615510">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p15193856757">Retention time of the idle state. The unit is second. The default value is <span class="parmvalue" id="dli_02_0228__parmvalue2267391352"><b>3600</b></span>.</p>
</td>
</tr>
<tr id="dli_02_0228__row1321714314112"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p1921793115118">job_type</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p192177311117">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p112174313119">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p597173717169">Job type. The options include <strong id="dli_02_0228__b795016397297">flink_sql_job</strong> and <strong id="dli_02_0228__b1399954452917">flink_opensource_sql_job</strong>.</p>
<p id="dli_02_0228__p16340145533917">The default value is <strong id="dli_02_0228__b95208528293">flink_opensource_sql_job</strong>.</p>
<ul id="dli_02_0228__ul14520163841811"><li id="dli_02_0228__li05201338161813">If <strong id="dli_02_0228__b164442214229">run_mode</strong> is set to <strong id="dli_02_0228__b20542192592214">exclusive_cluster</strong>, <strong id="dli_02_0228__b14331154672220">job_type</strong> must be set to <strong id="dli_02_0228__b799518544226">flink_sql_job</strong> or <strong id="dli_02_0228__b82128172314">flink_opensource_sql_job</strong>.</li><li id="dli_02_0228__li11218190104715">If <strong id="dli_02_0228__b204401021132316">run_mode</strong> is set to <strong id="dli_02_0228__b441624152318">shared_cluster</strong>, <strong id="dli_02_0228__b3328438172316">job_type</strong> must be set to <strong id="dli_02_0228__b12432174714234">flink_sql_job</strong>.</li></ul>
</td>
</tr>
<tr id="dli_02_0228__row1977812466369"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p1842823984611">dirty_data_strategy</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p164285395469">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p94281539184614">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p1842883912463">Dirty data policy of a job.</p>
<ul id="dli_02_0228__ul14821163115417"><li id="dli_02_0228__li1182114311541"><strong id="dli_02_0228__b444719122502">2:obsDir</strong>: Save. <strong id="dli_02_0228__b1348914504507">obsDir</strong> specifies the path for storing dirty data.</li><li id="dli_02_0228__li19342046105619"><strong id="dli_02_0228__b035122212519">1</strong>: Trigger a job exception</li><li id="dli_02_0228__li1891112118577"><strong id="dli_02_0228__b3741181916514">0</strong>: Ignore</li></ul>
<p id="dli_02_0228__p17304143102218">The default value is <strong id="dli_02_0228__b161355914564">0</strong>.</p>
</td>
</tr>
<tr id="dli_02_0228__row16141247203911"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p19470241751">udf_jar_url</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p19474241851">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p1894820241519">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p894882416512">Name of the resource package that has been uploaded to the DLI resource management system. The UDF Jar file of the SQL job is specified by this parameter.</p>
<p id="dli_02_0228__p13248103944810">For Flink 1.15 or later, only OBS packages can be selected when creating jobs, and DLI packages are not supported.</p>
</td>
</tr>
<tr id="dli_02_0228__row21601724348"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p3942456173617">manager_cu_number</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p1494215615362">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p3942135673612">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p29421456113614">Number of CUs in the JobManager selected for a job. The default value is <strong id="dli_02_0228__b9275125032620">1</strong>.</p>
</td>
</tr>
<tr id="dli_02_0228__row10739195520211"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p62741531828">tm_cus</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p1827415533218">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p132740531925">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p9274165315217">Number of CUs for each TaskManager. The default value is <strong id="dli_02_0228__b63443117276">1</strong>.</p>
</td>
</tr>
<tr id="dli_02_0228__row773817551425"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p122748531625">tm_slot_num</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p1274125315210">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p1327455313218">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p4275145317210">Number of slots in each TaskManager. The default value is <strong id="dli_02_0228__b74211119182818">(parallel_number*tm_cus)/(cu_number-manager_cu_number)</strong>.</p>
</td>
</tr>
<tr id="dli_02_0228__row1136167132716"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p2335124251810">resume_checkpoint</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p173354422187">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p113357429186">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p233519428187">Whether the abnormal restart is recovered from the checkpoint.</p>
</td>
</tr>
<tr id="dli_02_0228__row1713487162714"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p3543245162311">resume_max_num</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p9541245182312">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p185409459238">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p1549119459232">Maximum number of retry times upon exceptions. The unit is times/hour. Value range: -1 or greater than 0. The default value is <strong id="dli_02_0228__b18729368333">-1</strong>, indicating that the number of times is unlimited.</p>
</td>
</tr>
<tr id="dli_02_0228__row7554171585116"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p1364431775213">tags</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p13644017145212">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p964531775213">Array of objects</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p196451017195219">Label of a Flink SQL job. For details, see <a href="#dli_02_0228__table9391124139">Table 3</a>.</p>
</td>
</tr>
<tr id="dli_02_0228__row746162055613"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p95362034690">runtime_config</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p165376345912">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p25373349919">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p1153712346915">Customizes optimization parameters when a Flink job is running.</p>
</td>
</tr>
<tr id="dli_02_0228__row9956303347"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p151566375316">flink_version</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p11156633539">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p171568315310">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p1815673185311">Flink version.</p>
</td>
</tr>
<tr id="dli_02_0228__row16805331154014"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p148061031114015">execution_agency_urn</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p38351058144015">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p483515587401">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p1780610316406">Name of the agency authorized to DLI. This parameter is configurable in Flink 1.15.</p>
</td>
</tr>
<tr id="dli_02_0228__row181091039114518"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p1110911398454">resource_config_version</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p3109039124510">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p121091439184512">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p11099398457">Resource configuration version. The value can be<strong id="dli_02_0228__b3579171115017"> v1</strong> or <strong id="dli_02_0228__b1227317132013">v2</strong>. The default value is <strong id="dli_02_0228__b131431916402">v1</strong>.</p>
<p id="dli_02_0228__p542734105019">Compared with the v1 template, the v2 template does not support the setting of the number of CUs. The v2 template supports the setting of <strong id="dli_02_0228__b112464551017">Job Manager Memory</strong> and <strong id="dli_02_0228__b737010585010">Task Manager Memory</strong>.</p>
<p id="dli_02_0228__p07905434811"><strong id="dli_02_0228__b16610341015">v1</strong>: applicable to Flink 1.12, 1.13, and 1.15</p>
<p id="dli_02_0228__p395719814484"><strong id="dli_02_0228__b1848925417113">v2</strong>: applicable to Flink 1.13, 1.15, and 1.17.</p>
<p id="dli_02_0228__p114031754204512">You are advised to use the parameter settings of v2.</p>
</td>
</tr>
<tr id="dli_02_0228__row2011914110450"><td class="cellrowborder" valign="top" width="20.84%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0228__p1611974194517">resource_config</p>
</td>
<td class="cellrowborder" valign="top" width="12.13%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0228__p54006714610">No</p>
</td>
<td class="cellrowborder" valign="top" width="11.63%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0228__p7400272462">Object</p>
</td>
<td class="cellrowborder" valign="top" width="55.400000000000006%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0228__p14164812183011">Resource configuration of a Flink job. For detailed parameter descriptions, refer to <a href="#dli_02_0228__table193993254472">Table 4</a>.</p>
<p id="dli_02_0228__p20119104164515">When the resource configuration version is <strong id="dli_02_0228__b21071257332">v2</strong>, the configuration takes effect; when the resource configuration version is <strong id="dli_02_0228__b20931152412">v1</strong>, the configuration is invalid.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="dli_02_0228__table9391124139"></a><a name="table9391124139"></a><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0228__table9391124139" frame="border" border="1" rules="all"><caption><b>Table 3 </b>tags parameters</caption><thead align="left"><tr id="dli_02_0228__row1440020130"><th align="left" class="cellrowborder" valign="top" width="14.899999999999999%" id="mcps1.3.3.3.2.5.1.1"><p id="dli_02_0228__p194012219139">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="10.83%" id="mcps1.3.3.3.2.5.1.2"><p id="dli_02_0228__p540724136">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16.470000000000002%" id="mcps1.3.3.3.2.5.1.3"><p id="dli_02_0228__p840162161315">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="57.8%" id="mcps1.3.3.3.2.5.1.4"><p id="dli_02_0228__p16401271318">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0228__row194013231317"><td class="cellrowborder" valign="top" width="14.899999999999999%" headers="mcps1.3.3.3.2.5.1.1 "><p id="dli_02_0228__p13401329138">key</p>
</td>
<td class="cellrowborder" valign="top" width="10.83%" headers="mcps1.3.3.3.2.5.1.2 "><p id="dli_02_0228__p940102141313">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="16.470000000000002%" headers="mcps1.3.3.3.2.5.1.3 "><p id="dli_02_0228__p64019231317">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.8%" headers="mcps1.3.3.3.2.5.1.4 "><p id="dli_02_0228__p5401021139">Tag key</p>
<div class="note" id="dli_02_0228__note13334617185913"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="dli_02_0228__p103351817115920">A tag key can contain up to 128 characters, cannot start or end with a space, and cannot start with <strong id="dli_02_0228__b23781136134716">_sys_</strong>. Only letters, digits, spaces, and the following special characters are allowed: _.:+-@</p>
</div></div>
<div class="note" id="dli_02_0228__note642743816531"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="dli_02_0228__p18428738185310">A tag key can contain a maximum of 36 characters. Only letters, digits, hyphens (-), underscores (_), and spaces are allowed. The key cannot start or end with a space.</p>
</div></div>
</td>
</tr>
<tr id="dli_02_0228__row1141142181320"><td class="cellrowborder" valign="top" width="14.899999999999999%" headers="mcps1.3.3.3.2.5.1.1 "><p id="dli_02_0228__p164118215134">value</p>
</td>
<td class="cellrowborder" valign="top" width="10.83%" headers="mcps1.3.3.3.2.5.1.2 "><p id="dli_02_0228__p1141112181317">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="16.470000000000002%" headers="mcps1.3.3.3.2.5.1.3 "><p id="dli_02_0228__p174114281318">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.8%" headers="mcps1.3.3.3.2.5.1.4 "><p id="dli_02_0228__p16411125137">Tag value</p>
<div class="note" id="dli_02_0228__note17686539175910"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="dli_02_0228__p368612392599">A tag value can contain up to 255 characters. Only letters, digits, spaces, and the following special characters are allowed: _.:+-@</p>
</div></div>
<div class="note" id="dli_02_0228__note132645919543"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="dli_02_0228__p2265119185419">A tag value can contain up to 43 characters and cannot start or end with a space. Only letters, digits, hyphens (-), underscores (_), and periods (.) are allowed.</p>
</div></div>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="dli_02_0228__table193993254472"></a><a name="table193993254472"></a><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0228__table193993254472" frame="border" border="1" rules="all"><caption><b>Table 4 </b>resource_config parameters</caption><thead align="left"><tr id="dli_02_0228__row53997259477"><th align="left" class="cellrowborder" valign="top" width="14.899999999999999%" id="mcps1.3.3.4.2.5.1.1"><p id="dli_02_0228__p63997257471">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="10.83%" id="mcps1.3.3.4.2.5.1.2"><p id="dli_02_0228__p639917255473">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16.470000000000002%" id="mcps1.3.3.4.2.5.1.3"><p id="dli_02_0228__p339942511472">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="57.8%" id="mcps1.3.3.4.2.5.1.4"><p id="dli_02_0228__p6399182510476">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0228__row2039914258478"><td class="cellrowborder" valign="top" width="14.899999999999999%" headers="mcps1.3.3.4.2.5.1.1 "><p id="dli_02_0228__p73990255476">max_slot</p>
</td>
<td class="cellrowborder" valign="top" width="10.83%" headers="mcps1.3.3.4.2.5.1.2 "><p id="dli_02_0228__p839992534710">No</p>
</td>
<td class="cellrowborder" valign="top" width="16.470000000000002%" headers="mcps1.3.3.4.2.5.1.3 "><p id="dli_02_0228__p20399025124714">integer</p>
</td>
<td class="cellrowborder" valign="top" width="57.8%" headers="mcps1.3.3.4.2.5.1.4 "><p id="dli_02_0228__p211117201781">Number of parallel tasks that a single TaskManager can support. Each task slot can execute one task in parallel. Increasing task slots enhances the parallel processing capacity of the TaskManager but also increases resource consumption.</p>
<p id="dli_02_0228__p67979351043">The number of task slots is linked to the CPU count of the TaskManager since each CPU can offer one task slot.</p>
<p id="dli_02_0228__p99344521881">By default, a single TM slot is set to <strong id="dli_02_0228__b19908181019711">1</strong>. The minimum parallelism must not be less than 1.</p>
</td>
</tr>
<tr id="dli_02_0228__row232112118481"><td class="cellrowborder" valign="top" width="14.899999999999999%" headers="mcps1.3.3.4.2.5.1.1 "><p id="dli_02_0228__p143221711194818">parallel_number</p>
</td>
<td class="cellrowborder" valign="top" width="10.83%" headers="mcps1.3.3.4.2.5.1.2 "><p id="dli_02_0228__p193221711164814">No</p>
</td>
<td class="cellrowborder" valign="top" width="16.470000000000002%" headers="mcps1.3.3.4.2.5.1.3 "><p id="dli_02_0228__p4322211164810">integer</p>
</td>
<td class="cellrowborder" valign="top" width="57.8%" headers="mcps1.3.3.4.2.5.1.4 "><p id="dli_02_0228__p193224116488">Number of tasks concurrently executed by each operator in a job. The default value is <strong id="dli_02_0228__b1131914110107">1</strong>.</p>
</td>
</tr>
<tr id="dli_02_0228__row1926679164813"><td class="cellrowborder" valign="top" width="14.899999999999999%" headers="mcps1.3.3.4.2.5.1.1 "><p id="dli_02_0228__p62666914483">jobmanager_resource_spec</p>
</td>
<td class="cellrowborder" valign="top" width="10.83%" headers="mcps1.3.3.4.2.5.1.2 "><p id="dli_02_0228__p192661991485">No</p>
</td>
<td class="cellrowborder" valign="top" width="16.470000000000002%" headers="mcps1.3.3.4.2.5.1.3 "><p id="dli_02_0228__p1526611914816">Object</p>
</td>
<td class="cellrowborder" valign="top" width="57.8%" headers="mcps1.3.3.4.2.5.1.4 "><p id="dli_02_0228__p326669174817">JobManager resource specifications. For details about the parameters, see <a href="#dli_02_0228__table7152833178">Table 5</a>.</p>
</td>
</tr>
<tr id="dli_02_0228__row12399925194719"><td class="cellrowborder" valign="top" width="14.899999999999999%" headers="mcps1.3.3.4.2.5.1.1 "><p id="dli_02_0228__p12751203717">taskmanager_resource_spec</p>
</td>
<td class="cellrowborder" valign="top" width="10.83%" headers="mcps1.3.3.4.2.5.1.2 "><p id="dli_02_0228__p075101377">No</p>
</td>
<td class="cellrowborder" valign="top" width="16.470000000000002%" headers="mcps1.3.3.4.2.5.1.3 "><p id="dli_02_0228__p18752006719">Object</p>
</td>
<td class="cellrowborder" valign="top" width="57.8%" headers="mcps1.3.3.4.2.5.1.4 "><p id="dli_02_0228__p275120574">TaskManager resource specifications. For details about the parameters, see <a href="#dli_02_0228__table138972571488">Table 6</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="dli_02_0228__table7152833178"></a><a name="table7152833178"></a><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0228__table7152833178" frame="border" border="1" rules="all"><caption><b>Table 5 </b>jobmanager_resource_spec parameters</caption><thead align="left"><tr id="dli_02_0228__row515213331372"><th align="left" class="cellrowborder" valign="top" width="14.899999999999999%" id="mcps1.3.3.5.2.5.1.1"><p id="dli_02_0228__p0152833571">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="10.83%" id="mcps1.3.3.5.2.5.1.2"><p id="dli_02_0228__p121521933275">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16.470000000000002%" id="mcps1.3.3.5.2.5.1.3"><p id="dli_02_0228__p141521833475">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="57.8%" id="mcps1.3.3.5.2.5.1.4"><p id="dli_02_0228__p015283318715">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0228__row8152173315713"><td class="cellrowborder" valign="top" width="14.899999999999999%" headers="mcps1.3.3.5.2.5.1.1 "><p id="dli_02_0228__p915219338711">cpu</p>
</td>
<td class="cellrowborder" valign="top" width="10.83%" headers="mcps1.3.3.5.2.5.1.2 "><p id="dli_02_0228__p1615243320719">No</p>
</td>
<td class="cellrowborder" valign="top" width="16.470000000000002%" headers="mcps1.3.3.5.2.5.1.3 "><p id="dli_02_0228__p715311333713">double</p>
</td>
<td class="cellrowborder" valign="top" width="57.8%" headers="mcps1.3.3.5.2.5.1.4 "><p id="dli_02_0228__p1515363315715">Number of CPU cores available for JobManager. The default value is <strong id="dli_02_0228__b8212162101214">1.0</strong> CPU core, with a minimum of no less than 0.5 CPU cores.</p>
</td>
</tr>
<tr id="dli_02_0228__row1315316337714"><td class="cellrowborder" valign="top" width="14.899999999999999%" headers="mcps1.3.3.5.2.5.1.1 "><p id="dli_02_0228__p1121251483">memory</p>
</td>
<td class="cellrowborder" valign="top" width="10.83%" headers="mcps1.3.3.5.2.5.1.2 "><p id="dli_02_0228__p17121358814">No</p>
</td>
<td class="cellrowborder" valign="top" width="16.470000000000002%" headers="mcps1.3.3.5.2.5.1.3 "><p id="dli_02_0228__p6121155587">string</p>
</td>
<td class="cellrowborder" valign="top" width="57.8%" headers="mcps1.3.3.5.2.5.1.4 "><p id="dli_02_0228__p16121115686">Memory that can be used by JobManager, in MB or GB. The default unit is GB. The default value is 4 GB, and the minimum value is 2 GB.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="dli_02_0228__table138972571488"></a><a name="table138972571488"></a><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0228__table138972571488" frame="border" border="1" rules="all"><caption><b>Table 6 </b>taskmanager_resource_spec parameters</caption><thead align="left"><tr id="dli_02_0228__row18972576816"><th align="left" class="cellrowborder" valign="top" width="14.899999999999999%" id="mcps1.3.3.6.2.5.1.1"><p id="dli_02_0228__p17897175716817">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="10.83%" id="mcps1.3.3.6.2.5.1.2"><p id="dli_02_0228__p28979572088">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16.470000000000002%" id="mcps1.3.3.6.2.5.1.3"><p id="dli_02_0228__p15897657483">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="57.8%" id="mcps1.3.3.6.2.5.1.4"><p id="dli_02_0228__p2089717571816">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0228__row5897125711814"><td class="cellrowborder" valign="top" width="14.899999999999999%" headers="mcps1.3.3.6.2.5.1.1 "><p id="dli_02_0228__p389718571686">cpu</p>
</td>
<td class="cellrowborder" valign="top" width="10.83%" headers="mcps1.3.3.6.2.5.1.2 "><p id="dli_02_0228__p289745710813">No</p>
</td>
<td class="cellrowborder" valign="top" width="16.470000000000002%" headers="mcps1.3.3.6.2.5.1.3 "><p id="dli_02_0228__p12897357689">double</p>
</td>
<td class="cellrowborder" valign="top" width="57.8%" headers="mcps1.3.3.6.2.5.1.4 "><p id="dli_02_0228__p48971657582">Number of CPU cores available for TaskManager. The default value is <strong id="dli_02_0228__b3431132710133">1.0</strong> CPU core, with a minimum of no less than 0.5 CPU cores.</p>
</td>
</tr>
<tr id="dli_02_0228__row19897105711816"><td class="cellrowborder" valign="top" width="14.899999999999999%" headers="mcps1.3.3.6.2.5.1.1 "><p id="dli_02_0228__p889717571985">memory</p>
</td>
<td class="cellrowborder" valign="top" width="10.83%" headers="mcps1.3.3.6.2.5.1.2 "><p id="dli_02_0228__p168971757883">No</p>
</td>
<td class="cellrowborder" valign="top" width="16.470000000000002%" headers="mcps1.3.3.6.2.5.1.3 "><p id="dli_02_0228__p18897115718813">string</p>
</td>
<td class="cellrowborder" valign="top" width="57.8%" headers="mcps1.3.3.6.2.5.1.4 "><p id="dli_02_0228__p158971457986">Memory that can be used by TaskManager, in MB or GB. The default unit is GB. The default value is 4 GB, and the minimum value is 2 GB.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="dli_02_0228__se2bf80cdb76541308f69f258ea4b1bd6"><h4 class="sectiontitle">Response Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0228__t5995d65f65ba4ebca8606202112b407e" frame="border" border="1" rules="all"><caption><b>Table 7 </b>Response parameters</caption><thead align="left"><tr id="dli_02_0228__ra7acea51e4b4437e917d21fe99f130a3"><th align="left" class="cellrowborder" valign="top" width="19.25%" id="mcps1.3.4.2.2.5.1.1"><p id="dli_02_0228__a5af940f2267747ef871c67c86a0be82e">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="14.44%" id="mcps1.3.4.2.2.5.1.2"><p id="dli_02_0228__abcfbd3a651704d539626f3a41cc744f5">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16.76%" id="mcps1.3.4.2.2.5.1.3"><p id="dli_02_0228__a2351d8d266444ad3ad1c09540d6d81cc">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="49.55%" id="mcps1.3.4.2.2.5.1.4"><p id="dli_02_0228__af7ea6a3f59844bdf99d51e90d570be4c">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0228__row2418154742"><td class="cellrowborder" valign="top" width="19.25%" headers="mcps1.3.4.2.2.5.1.1 "><p id="dli_02_0228__p2827183519">is_success</p>
</td>
<td class="cellrowborder" valign="top" width="14.44%" headers="mcps1.3.4.2.2.5.1.2 "><p id="dli_02_0228__p6362111364911">No</p>
</td>
<td class="cellrowborder" valign="top" width="16.76%" headers="mcps1.3.4.2.2.5.1.3 "><p id="dli_02_0228__p118601817517">String</p>
</td>
<td class="cellrowborder" valign="top" width="49.55%" headers="mcps1.3.4.2.2.5.1.4 "><p id="dli_02_0228__p1487318359">Indicates whether the request is successfully executed. Value <span class="parmvalue" id="dli_02_0228__parmvalue18862182863417"><b>true</b></span> indicates that the request is successfully executed.</p>
</td>
</tr>
<tr id="dli_02_0228__row64180541741"><td class="cellrowborder" valign="top" width="19.25%" headers="mcps1.3.4.2.2.5.1.1 "><p id="dli_02_0228__a4aba020b918e457a8a3d15e7ebaeb20d">message</p>
</td>
<td class="cellrowborder" valign="top" width="14.44%" headers="mcps1.3.4.2.2.5.1.2 "><p id="dli_02_0228__p11374111319494">No</p>
</td>
<td class="cellrowborder" valign="top" width="16.76%" headers="mcps1.3.4.2.2.5.1.3 "><p id="dli_02_0228__ac85edc0a27d044b0ad524a4124e59e4c">String</p>
</td>
<td class="cellrowborder" valign="top" width="49.55%" headers="mcps1.3.4.2.2.5.1.4 "><p id="dli_02_0228__ac087aec9dfcc407ba244ad3e96b23257">Message content.</p>
</td>
</tr>
<tr id="dli_02_0228__row15874961669"><td class="cellrowborder" valign="top" width="19.25%" headers="mcps1.3.4.2.2.5.1.1 "><p id="dli_02_0228__p933863862615">job</p>
</td>
<td class="cellrowborder" valign="top" width="14.44%" headers="mcps1.3.4.2.2.5.1.2 "><p id="dli_02_0228__p9338638122617">No</p>
</td>
<td class="cellrowborder" valign="top" width="16.76%" headers="mcps1.3.4.2.2.5.1.3 "><p id="dli_02_0228__p33383387265">Object</p>
</td>
<td class="cellrowborder" valign="top" width="49.55%" headers="mcps1.3.4.2.2.5.1.4 "><p id="dli_02_0228__p18338103822617">Information about the job status. For details, see <a href="#dli_02_0228__table86492245453">Table 8</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="dli_02_0228__table86492245453"></a><a name="table86492245453"></a><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0228__table86492245453" frame="border" border="1" rules="all"><caption><b>Table 8 </b>job parameters</caption><thead align="left"><tr id="dli_02_0228__row176501524184518"><th align="left" class="cellrowborder" valign="top" width="19.25%" id="mcps1.3.4.3.2.5.1.1"><p id="dli_02_0228__p18650152414511">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="14.44%" id="mcps1.3.4.3.2.5.1.2"><p id="dli_02_0228__p10650424204518">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="13.370000000000001%" id="mcps1.3.4.3.2.5.1.3"><p id="dli_02_0228__p865022420455">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="52.94%" id="mcps1.3.4.3.2.5.1.4"><p id="dli_02_0228__p10650192416454">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0228__row1965211245455"><td class="cellrowborder" valign="top" width="19.25%" headers="mcps1.3.4.3.2.5.1.1 "><p id="dli_02_0228__p265214241459">job_id</p>
</td>
<td class="cellrowborder" valign="top" width="14.44%" headers="mcps1.3.4.3.2.5.1.2 "><p id="dli_02_0228__p176521824104518">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="13.370000000000001%" headers="mcps1.3.4.3.2.5.1.3 "><p id="dli_02_0228__p965292416455">Long</p>
</td>
<td class="cellrowborder" valign="top" width="52.94%" headers="mcps1.3.4.3.2.5.1.4 "><p id="dli_02_0228__p26525248455">Job ID.</p>
</td>
</tr>
<tr id="dli_02_0228__row1465210242456"><td class="cellrowborder" valign="top" width="19.25%" headers="mcps1.3.4.3.2.5.1.1 "><p id="dli_02_0228__p1465252404513">status_name</p>
</td>
<td class="cellrowborder" valign="top" width="14.44%" headers="mcps1.3.4.3.2.5.1.2 "><p id="dli_02_0228__p8652624134510">No</p>
</td>
<td class="cellrowborder" valign="top" width="13.370000000000001%" headers="mcps1.3.4.3.2.5.1.3 "><p id="dli_02_0228__p665282413457">String</p>
</td>
<td class="cellrowborder" valign="top" width="52.94%" headers="mcps1.3.4.3.2.5.1.4 "><p id="dli_02_0228__p156531124134510">Name of job status. For details, see the description of the <strong id="dli_02_0228__b13389173113514">status</strong> field in <a href="dli_02_0235.html">Querying Job Details</a>.</p>
</td>
</tr>
<tr id="dli_02_0228__row1865352464519"><td class="cellrowborder" valign="top" width="19.25%" headers="mcps1.3.4.3.2.5.1.1 "><p id="dli_02_0228__p1665314248452">status_desc</p>
</td>
<td class="cellrowborder" valign="top" width="14.44%" headers="mcps1.3.4.3.2.5.1.2 "><p id="dli_02_0228__p15653122464517">No</p>
</td>
<td class="cellrowborder" valign="top" width="13.370000000000001%" headers="mcps1.3.4.3.2.5.1.3 "><p id="dli_02_0228__p14653024114510">String</p>
</td>
<td class="cellrowborder" valign="top" width="52.94%" headers="mcps1.3.4.3.2.5.1.4 "><p id="dli_02_0228__p565313246452">Status description. Causes and suggestions for the abnormal status.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="dli_02_0228__section1130754105710"><h4 class="sectiontitle">Example Request</h4><p id="dli_02_0228__p1954203819496">Use the template whose ID is <strong id="dli_02_0228__b1871618245330">100000</strong> to create a Flink SQL job named <strong id="dli_02_0228__b5941193823316">myjob</strong>. The job runs in dedicated mode on the <strong id="dli_02_0228__b1195842117345">testQueue</strong> queue.</p>
<pre class="screen" id="dli_02_0228__screen17915151213913">{
"name": "myjob",
"desc": "This is a job used for counting characters.",
"template_id": 100000,
"queue_name": "testQueue",
"sql_body": "select * from source_table",
"run_mode": "exclusive_cluster",
"cu_number": 2,
"parallel_number": 1,
"checkpoint_enabled": false,
"checkpoint_mode": "exactly_once",
"checkpoint_interval": 0,
"obs_bucket": "my_obs_bucket",
"log_enabled": false,
"restart_when_exception": false,
"idle_state_retention": 3600,
"job_type": "flink_sql_job",
"dirty_data_strategy": "0",
"execution_agency_urn": "myAgencyName",
"udf_jar_url": "group/test.jar"
}</pre>
</div>
<div class="section" id="dli_02_0228__section611513417318"><h4 class="sectiontitle">Example Response</h4><pre class="screen" id="dli_02_0228__screen3128586398">{
"is_success": "true",
"message": "A DLI job is created successfully.",
"job": {
"job_id": 148,
"status_name": "job_init",
"status_desc": ""
}
}</pre>
</div>
<div class="section" id="dli_02_0228__s1b495ba11cd9411c9ad2ee50103334a7"><h4 class="sectiontitle">Status Codes</h4><p id="dli_02_0228__acef1445366354016b2ed90921927a555"><a href="#dli_02_0228__t43c1f1c0ba344f4cbcb270953d9cca2a">Table 9</a> describes status codes.</p>
<div class="tablenoborder"><a name="dli_02_0228__t43c1f1c0ba344f4cbcb270953d9cca2a"></a><a name="t43c1f1c0ba344f4cbcb270953d9cca2a"></a><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0228__t43c1f1c0ba344f4cbcb270953d9cca2a" frame="border" border="1" rules="all"><caption><b>Table 9 </b>Status codes</caption><thead align="left"><tr id="dli_02_0228__r2ad0f008ce2248a1800a3e8b77226a56"><th align="left" class="cellrowborder" valign="top" width="30%" id="mcps1.3.7.3.2.3.1.1"><p id="dli_02_0228__afa33b7f5b0ac4d008ebcf6493f629b24">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="70%" id="mcps1.3.7.3.2.3.1.2"><p id="dli_02_0228__af801170b350b4f8ba3b575c7ddb8b13e">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_02_0228__r0b449b1d3b8c498ea3e6cce16c80a14c"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.7.3.2.3.1.1 "><p id="dli_02_0228__a8c63a97e3bad402ebaead0bd99cad632">200</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.7.3.2.3.1.2 "><p id="dli_02_0228__p828449123817">The job is created successfully.</p>
</td>
</tr>
<tr id="dli_02_0228__row264510302300"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.7.3.2.3.1.1 "><p id="dli_02_0228__p19646163033015">400</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.7.3.2.3.1.2 "><p id="dli_02_0228__p47552616316">The input parameter is invalid.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="dli_02_0228__section13596141025715"><h4 class="sectiontitle">Error Codes</h4><p id="dli_02_0228__dli_02_0225_p420584425712">If an error occurs when this API is invoked, the system does not return the result similar to the preceding example, but returns the error code and error information. For details, see <a href="dli_02_0056.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dli_02_0223.html">Flink Job-related APIs</a></div>
</div>
</div>
View Git Blame Copy Permalink