yexinru/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
Files
a41a4e0331fbc0beff63bb28fa59228cc9a751df
doc-exports/docs/dws/dev/dws_06_0281.html
luhuayi 177cd61a57 DWS DEVG 910.211 version 
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Co-authored-by: luhuayi <luhuayi@huawei.com>
Co-committed-by: luhuayi <luhuayi@huawei.com>
2025-05-05 07:44:03 +00:00

81 lines
12 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001811515653"></a><a name="EN-US_TOPIC_0000001811515653"></a>
<h1 class="topictitle1">CREATE EXCEPT RULE</h1>
<div id="body0000001334180054"><div class="section" id="EN-US_TOPIC_0000001811515653__s26b72b1858a44a5984f0fa6d9a84a67c"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0000001811515653__ae0128647c2ba4636aa6dfcf1ca144d9a">This syntax is used to create an exception rule set. When creating an exception rule, you can specify the rule thresholds and operations following the triggering of an exception rule. Currently, only the <strong id="EN-US_TOPIC_0000001811515653__b1088913023420">abort</strong> operation is supported.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001811515653__sa59cc6cc8a984fd197fefdd1473b4d11"><h4 class="sectiontitle">Precautions</h4><p id="EN-US_TOPIC_0000001811515653__p10190979184">None</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001811515653__s3f9d958138244c4385543e5644eb82e6"><h4 class="sectiontitle">Syntax</h4><div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001811515653__s226ab8de9c9b4110b4900a71f69c2026"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
<span class="normal"> 5</span>
<span class="normal"> 6</span>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span>
<span class="normal">12</span>
<span class="normal">13</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">CREATE</span><span class="w"> </span><span class="k">EXCEPT</span><span class="w"> </span><span class="k">RULE</span><span class="w"> </span><span class="n">except_rule_name</span>
<span class="w"> </span><span class="k">WITH</span><span class="w"> </span><span class="p">(</span>
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">BLOCKTIME</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">VALUE</span><span class="p">,</span>
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">CPUTIME</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">VALUE</span><span class="p">,</span>
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">ELAPSEDTIME</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">VALUE</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">CPUSKEWPERCENT</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">VALUE</span><span class="p">,</span>
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">SPILLSIZE</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">VALUE</span><span class="p">,</span>
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">BROADCASTSIZE</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">VALUE</span><span class="p">,</span>
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">MEMSIZE</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">VALUE</span><span class="p">,</span>
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">CPUAVGPERCENT</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">VALUE</span><span class="p">,</span>
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">BANDWIDTH</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">VALUE</span><span class="p">,</span>
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">ACTION</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[</span><span class="s1">'abort'</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="s1">'penalty'</span><span class="p">]</span>
<span class="w"> </span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001811515653__s3af932ca438d4159985b0e2e173ebf9d"><h4 class="sectiontitle">Parameter Description</h4><ul id="EN-US_TOPIC_0000001811515653__ul63681331144619"><li id="EN-US_TOPIC_0000001811515653__lfde7b0ce8c3c4a5db0f3b2fc758835d7"><strong id="EN-US_TOPIC_0000001811515653__b95138267264">rule_name</strong><p id="EN-US_TOPIC_0000001811515653__p2018433855115">Name of an exception rule set.</p>
<p id="EN-US_TOPIC_0000001811515653__ad6abc158ac654e4695c2673e7abbb344">Value range: a string of 1 to 64 characters. It must comply with the naming convention.</p>
</li></ul>
<ul id="EN-US_TOPIC_0000001811515653__ue04df989bfb94df7b21de1f71b56727c"><li id="EN-US_TOPIC_0000001811515653__l7b3eb7d573c345b795328479824cbcac"><strong id="EN-US_TOPIC_0000001811515653__b16814541132619">blocktime</strong><p id="EN-US_TOPIC_0000001811515653__a855815071ce9482a9b571eaa0b62e55d">Maximum duration of job queue blocking, in seconds.</p>
<p id="EN-US_TOPIC_0000001811515653__ac7accc73617e4d09838c7e11aac86c19">Value range: -1, 1~INT64_MAX</p>
</li><li id="EN-US_TOPIC_0000001811515653__li1431012165011"><strong id="EN-US_TOPIC_0000001811515653__b42701454182614">elapsedtime</strong><p id="EN-US_TOPIC_0000001811515653__p146241649104916">Maximum job execution duration, in seconds.</p>
<p id="EN-US_TOPIC_0000001811515653__p7624449154919">Value range: -1, 1~INT64_MAX</p>
</li><li id="EN-US_TOPIC_0000001811515653__li154091147473"><strong id="EN-US_TOPIC_0000001811515653__b1489735712262">allcputime</strong><p id="EN-US_TOPIC_0000001811515653__p1478112286502">Maximum CPU time used during job running. The unit is second.</p>
<p id="EN-US_TOPIC_0000001811515653__p4781182885015">Value range: -1, 1~INT64_MAX</p>
</li><li id="EN-US_TOPIC_0000001811515653__li5446318154715"><strong id="EN-US_TOPIC_0000001811515653__b489017216277">cpuskewpercent</strong><p id="EN-US_TOPIC_0000001811515653__p5389153225317">Average CPU usage during job execution. The unit is percentage.</p>
<p id="EN-US_TOPIC_0000001811515653__p138917322534">Value range: -1, 1-100.</p>
</li><li id="EN-US_TOPIC_0000001811515653__li732665519503"><strong id="EN-US_TOPIC_0000001811515653__b1728177112718">cpuavgpercent</strong><p id="EN-US_TOPIC_0000001811515653__p63451547155011">CPU usage skew during job execution. The unit is percentage.</p>
<p id="EN-US_TOPIC_0000001811515653__p13488105595010">Value range: -1, 1-100.</p>
</li><li id="EN-US_TOPIC_0000001811515653__li8500132414717"><strong id="EN-US_TOPIC_0000001811515653__b168295107270">spillsize</strong><p id="EN-US_TOPIC_0000001811515653__p1662013344504">Maximum size of data spilled to disks during job execution. The unit is MB.</p>
<p id="EN-US_TOPIC_0000001811515653__p2620133435014">Value range: -1, 1~INT64_MAX</p>
</li><li id="EN-US_TOPIC_0000001811515653__li17681228124711"><strong id="EN-US_TOPIC_0000001811515653__b196613145271">broadcastsize</strong><p id="EN-US_TOPIC_0000001811515653__p10452143713501">Maximum broadcast size of a job. The unit is MB.</p>
<p id="EN-US_TOPIC_0000001811515653__p34521037175013">Value range: -1, 1~INT64_MAX</p>
</li><li id="EN-US_TOPIC_0000001811515653__li10833331154712"><strong id="EN-US_TOPIC_0000001811515653__b374021817272">memsize</strong><p id="EN-US_TOPIC_0000001811515653__p7172047191513">Maximum memory size used for job execution. Unit: MB.</p>
<p id="EN-US_TOPIC_0000001811515653__p717210476153">Value range: -1, 1~INT64_MAX</p>
</li><li id="EN-US_TOPIC_0000001811515653__li1654416596483"><strong id="EN-US_TOPIC_0000001811515653__b49318549817">bandwidth</strong><p id="EN-US_TOPIC_0000001811515653__p0544185934814">Maximum bandwidth that can be used for job execution. Unit: MB.</p>
<p id="EN-US_TOPIC_0000001811515653__p1354412598485">Value range: -1, 1~INT64_MAX</p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001811515653__section370345415718"><h4 class="sectiontitle">Examples</h4><p id="EN-US_TOPIC_0000001811515653__p1125691913019">Create exception rule set <strong id="EN-US_TOPIC_0000001811515653__b5181162617367">except_rule1</strong> and set the <strong id="EN-US_TOPIC_0000001811515653__b19996450113714">blocktime</strong> threshold to <strong id="EN-US_TOPIC_0000001811515653__b1140465123612">3000 seconds</strong>, and spilling space to <strong id="EN-US_TOPIC_0000001811515653__b919510811374">4000 MB</strong>.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001811515653__screen154144343012"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">CREATE</span><span class="w"> </span><span class="k">EXCEPT</span><span class="w"> </span><span class="k">RULE</span><span class="w"> </span><span class="n">except_rule1</span><span class="w"> </span><span class="k">WITH</span><span class="w"> </span><span class="p">(</span><span class="n">blocktime</span><span class="o">=</span><span class="mi">3000</span><span class="p">,</span><span class="w"> </span><span class="n">spillsize</span><span class="o">=</span><span class="mi">4000</span><span class="p">,</span><span class="w"> </span><span class="n">action</span><span class="o">=</span><span class="k">abort</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001811515653__p1922044793016">Create an exception rule set <strong id="EN-US_TOPIC_0000001811515653__b2171525153720">except_rule2</strong> and set the <strong id="EN-US_TOPIC_0000001811515653__b413564743715">memsize</strong> threshold to <strong id="EN-US_TOPIC_0000001811515653__b43789575376">5000 MB</strong>. The default operation following an exception is <strong id="EN-US_TOPIC_0000001811515653__b944210317381">abort</strong>.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001811515653__screen6321053203115"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">CREATE</span><span class="w"> </span><span class="k">EXCEPT</span><span class="w"> </span><span class="k">RULE</span><span class="w"> </span><span class="n">except_rule2</span><span class="w"> </span><span class="k">WITH</span><span class="w"> </span><span class="p">(</span><span class="n">memsize</span><span class="o">=</span><span class="mi">3000</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001811515653__p166021316217">Create a resource pool and bind it to exception rule set <strong id="EN-US_TOPIC_0000001811515653__b134445422382">except_rule3</strong>.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001811515653__screen86021172113"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">CREATE</span><span class="w"> </span><span class="n">resource</span><span class="w"> </span><span class="n">pool</span><span class="w"> </span><span class="n">resource_pool_a1</span><span class="w"> </span><span class="k">WITH</span><span class="w"> </span><span class="p">(</span><span class="n">except_rule</span><span class="o">=</span><span class="s1">'except_rule3'</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001811515653__section1952411183338"><h4 class="sectiontitle">Helpful Links</h4><p id="EN-US_TOPIC_0000001811515653__p20449162103314"><a href="dws_06_0280.html">ALTER EXCEPT RULE</a>, <a href="dws_06_0282.html">DROP EXCEPT RULE</a></p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_06_0118.html">DDL Syntax</a></div>
</div>
</div>
View Git Blame Copy Permalink