vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/dws/dev/dws_06_0280.html
Lu, Huayi ef0ada5a59 DWS DEV 20240716 version 
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Co-authored-by: Lu, Huayi <luhuayi@huawei.com>
Co-committed-by: Lu, Huayi <luhuayi@huawei.com>
2024-11-02 09:07:47 +00:00

85 lines
13 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001460721252"></a><a name="EN-US_TOPIC_0000001460721252"></a>
<h1 class="topictitle1">ALTER EXCEPT RULE</h1>
<div id="body0000001385059665"><div class="section" id="EN-US_TOPIC_0000001460721252__s26b72b1858a44a5984f0fa6d9a84a67c"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0000001460721252__ae0128647c2ba4636aa6dfcf1ca144d9a">Modifies an exception rule set. You can modify one or more specific rule thresholds in a rule set.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001460721252__sa59cc6cc8a984fd197fefdd1473b4d11"><h4 class="sectiontitle">Precautions</h4><p id="EN-US_TOPIC_0000001460721252__ac7442e4e9fb44c3fbc73c718a3dc12ce">None</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001460721252__s3f9d958138244c4385543e5644eb82e6"><h4 class="sectiontitle">Syntax</h4><div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001460721252__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">ALTER</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_0000001460721252__s3af932ca438d4159985b0e2e173ebf9d"><h4 class="sectiontitle">Parameter Description</h4><ul id="EN-US_TOPIC_0000001460721252__ul63681331144619"><li id="EN-US_TOPIC_0000001460721252__lfde7b0ce8c3c4a5db0f3b2fc758835d7"><strong id="EN-US_TOPIC_0000001460721252__b714301444114">rule_name</strong><p id="EN-US_TOPIC_0000001460721252__ad6abc158ac654e4695c2673e7abbb344">Name of an exception rule set.</p>
<p id="EN-US_TOPIC_0000001460721252__a57c751b7b8a14544aed1d4dc1b06da8d">Value range: a string. It must comply with the naming convention.</p>
</li></ul>
<ul id="EN-US_TOPIC_0000001460721252__ue04df989bfb94df7b21de1f71b56727c"><li id="EN-US_TOPIC_0000001460721252__l7b3eb7d573c345b795328479824cbcac"><strong id="EN-US_TOPIC_0000001460721252__b225181824119">blocktime</strong><p id="EN-US_TOPIC_0000001460721252__a855815071ce9482a9b571eaa0b62e55d">Maximum duration of job queue blocking, in seconds.</p>
<p id="EN-US_TOPIC_0000001460721252__ac7accc73617e4d09838c7e11aac86c19">Value range: -1, 1~INT64_MAX</p>
</li><li id="EN-US_TOPIC_0000001460721252__li1431012165011"><strong id="EN-US_TOPIC_0000001460721252__b143551622124115">elapsedtime</strong><p id="EN-US_TOPIC_0000001460721252__p146241649104916">Maximum job execution duration, in seconds.</p>
<p id="EN-US_TOPIC_0000001460721252__p7624449154919">Value range: -1, 1~INT64_MAX</p>
</li><li id="EN-US_TOPIC_0000001460721252__li154091147473"><strong id="EN-US_TOPIC_0000001460721252__b1099318257411">allcputime</strong><p id="EN-US_TOPIC_0000001460721252__p1478112286502">Maximum CPU time used during job running. The unit is second.</p>
<p id="EN-US_TOPIC_0000001460721252__p4781182885015">Value range: -1, 1~INT64_MAX</p>
</li><li id="EN-US_TOPIC_0000001460721252__li5446318154715"><strong id="EN-US_TOPIC_0000001460721252__b36641296411">cpuskewpercent</strong><p id="EN-US_TOPIC_0000001460721252__p5389153225317">CPU usage skew during job execution. The unit is percentage.</p>
<p id="EN-US_TOPIC_0000001460721252__p138917322534">Value range: -1, 1-100.</p>
</li><li id="EN-US_TOPIC_0000001460721252__li732665519503"><strong id="EN-US_TOPIC_0000001460721252__b159371135104113">cpuavgpercent</strong><p id="EN-US_TOPIC_0000001460721252__p63451547155011">Average CPU usage during job execution. The unit is percentage.</p>
<p id="EN-US_TOPIC_0000001460721252__p13488105595010">Value range: -1, 1-100.</p>
</li><li id="EN-US_TOPIC_0000001460721252__li8500132414717"><strong id="EN-US_TOPIC_0000001460721252__b325443994111">spillsize</strong><p id="EN-US_TOPIC_0000001460721252__p1662013344504">Maximum size of data spilled to disks during job execution. The unit is MB.</p>
<p id="EN-US_TOPIC_0000001460721252__p2620133435014">Value range: -1, 1~INT64_MAX</p>
</li><li id="EN-US_TOPIC_0000001460721252__li17681228124711"><strong id="EN-US_TOPIC_0000001460721252__b12802543104116">broadcastsize</strong><p id="EN-US_TOPIC_0000001460721252__p10452143713501">Maximum broadcast size of a job. The unit is MB.</p>
<p id="EN-US_TOPIC_0000001460721252__p34521037175013">Value range: -1, 1~INT64_MAX</p>
</li><li id="EN-US_TOPIC_0000001460721252__li10833331154712"><strong id="EN-US_TOPIC_0000001460721252__b1649119479411">memsize</strong><p id="EN-US_TOPIC_0000001460721252__p7172047191513">Maximum memory size used for job execution. Unit: MB.</p>
<p id="EN-US_TOPIC_0000001460721252__p717210476153">Value range: -1, 1~INT64_MAX</p>
</li><li id="EN-US_TOPIC_0000001460721252__li41727533496"><strong id="EN-US_TOPIC_0000001460721252__b1917275310493">bandwidth</strong><p id="EN-US_TOPIC_0000001460721252__p2172205318491">Maximum network bandwidth that can be used for job execution. Unit: MB.</p>
<p id="EN-US_TOPIC_0000001460721252__p7172115314910">Value range: -1, 1~INT64_MAX</p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001460721252__section370345415718"><h4 class="sectiontitle">Examples</h4><p id="EN-US_TOPIC_0000001460721252__p68767492587">Change the blocktime threshold of exception rule set <strong id="EN-US_TOPIC_0000001460721252__b9381939193619">except_rule1</strong> to <strong id="EN-US_TOPIC_0000001460721252__b469113294012">3000s</strong> and the space for spilled data to <strong id="EN-US_TOPIC_0000001460721252__b918018577419">4000 MB</strong>.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001460721252__screen12867154083812"><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">ALTER</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>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001460721252__p11730417173817">Change the spilled data size <strong id="EN-US_TOPIC_0000001460721252__b1514245484011">spillsize</strong> to <strong id="EN-US_TOPIC_0000001460721252__b17468185717404">5000 MB</strong> for the exception rule set <strong id="EN-US_TOPIC_0000001460721252__b142596411415">except_rule2</strong>.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001460721252__screen216515568387"><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">ALTER</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">spillsize</span><span class="o">=</span><span class="mi">5000</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001460721252__p166021316217">Change the exception rule set bound to resource pool <strong id="EN-US_TOPIC_0000001460721252__b1565795420428">resource_pool_a1</strong> to <strong id="EN-US_TOPIC_0000001460721252__b455371124317">except_rule3</strong>.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001460721252__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">ALTER</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>
<p id="EN-US_TOPIC_0000001460721252__p59012217308">Unbind the exception rule set from the resource pool <strong id="EN-US_TOPIC_0000001460721252__b128582203432">resource_pool_a1</strong>.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001460721252__screen1331861020583"><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">ALTER</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">'None'</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001460721252__section20450184711399"><h4 class="sectiontitle">Helpful Links</h4><p id="EN-US_TOPIC_0000001460721252__p47911651153910"><a href="dws_06_0281.html">CREATE 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