vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/dws/dev/dws_06_0147.html
Lu, Huayi e6fa411af0 DWS DEV 830.201 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-05-16 07:24:04 +00:00

91 lines
12 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001188270534"></a><a name="EN-US_TOPIC_0000001188270534"></a>
<h1 class="topictitle1">ALTER TRIGGER</h1>
<div id="body1551942823551"><div class="section" id="EN-US_TOPIC_0000001188270534__s11dbafd02fc245e8ab6884159af9fd0b"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0000001188270534__a14673df9357e4e28aaff1157cd3bde67"><strong id="EN-US_TOPIC_0000001188270534__b177371838063">ALTER TRIGGER</strong> modifies the definition of a trigger.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001188270534__s3885984ccb904e76a8b521140774edbb"><h4 class="sectiontitle">Precautions</h4><p id="EN-US_TOPIC_0000001188270534__a46e9880e43d943eeb7dacc9537d4e963">Only the owner of a table where a trigger is created and system administrators can run the <strong id="EN-US_TOPIC_0000001188270534__b357418472069">ALTER TRIGGER</strong> statement.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001188270534__s097e199c371040739945504301b7678d"><h4 class="sectiontitle">Syntax</h4><div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188270534__s49960349d09943568d3fc82d29c074fc"><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">TRIGGER</span><span class="w"> </span><span class="k">trigger_name</span><span class="w"> </span><span class="k">ON</span><span class="w"> </span><span class="k">table_name</span><span class="w"> </span><span class="k">RENAME</span><span class="w"> </span><span class="k">TO</span><span class="w"> </span><span class="n">new_name</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001188270534__s49eade590b0f4b098e648dd1dc5e3e60"><h4 class="sectiontitle">Parameter Description</h4><ul id="EN-US_TOPIC_0000001188270534__u94351f73b3e945628b8649a4f9cc4f3e"><li id="EN-US_TOPIC_0000001188270534__l58e147705fc64066994924862c8f66e5"><strong id="EN-US_TOPIC_0000001188270534__ae3fcc2a08f584332b3815a5209776e1a">trigger_name</strong><p id="EN-US_TOPIC_0000001188270534__ab6d27b2b82d348be80745fa87fb975c7">Specifies the name of the trigger to be modified.</p>
<p id="EN-US_TOPIC_0000001188270534__a9ee2ac78101e427f90c718c3df1d1e74">Value range: an existing trigger</p>
</li><li id="EN-US_TOPIC_0000001188270534__li11636184716594"><strong id="EN-US_TOPIC_0000001188270534__b10748195216598">table_name</strong><p id="EN-US_TOPIC_0000001188270534__p318211253564">Specifies the name of the table where the trigger to be modified is located.</p>
<p id="EN-US_TOPIC_0000001188270534__p185906551621">Value range: an existing table having a trigger</p>
</li><li id="EN-US_TOPIC_0000001188270534__li12515948132714"><strong id="EN-US_TOPIC_0000001188270534__b1068605218276">new_name</strong><p id="EN-US_TOPIC_0000001188270534__p13341238202719">Specifies the new trigger name.</p>
<p id="EN-US_TOPIC_0000001188270534__p917531510307">Value range: a string that complies with the identifier naming convention. A value contains a maximum of 63 characters and cannot be the same as other triggers on the same table.</p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001188270534__s974b31b9463848259512367e2d285b74"><h4 class="sectiontitle">Example</h4><p id="EN-US_TOPIC_0000001188270534__p20893492297">Create a source table and a trigger table:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188270534__screen1089184962911"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">DROP</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="k">IF</span><span class="w"> </span><span class="k">EXISTS</span><span class="w"> </span><span class="n">test_trigger_src_tbl</span><span class="p">;</span>
<span class="k">DROP</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="k">IF</span><span class="w"> </span><span class="k">EXISTS</span><span class="w"> </span><span class="n">test_trigger_des_tbl</span><span class="p">;</span>
<span class="k">CREATE</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">test_trigger_src_tbl</span><span class="p">(</span><span class="n">id1</span><span class="w"> </span><span class="nb">INT</span><span class="p">,</span><span class="w"> </span><span class="n">id2</span><span class="w"> </span><span class="nb">INT</span><span class="p">,</span><span class="w"> </span><span class="n">id3</span><span class="w"> </span><span class="nb">INT</span><span class="p">);</span>
<span class="k">CREATE</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">test_trigger_des_tbl</span><span class="p">(</span><span class="n">id1</span><span class="w"> </span><span class="nb">INT</span><span class="p">,</span><span class="w"> </span><span class="n">id2</span><span class="w"> </span><span class="nb">INT</span><span class="p">,</span><span class="w"> </span><span class="n">id3</span><span class="w"> </span><span class="nb">INT</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001188270534__p4891949192915">Create the trigger function <strong id="EN-US_TOPIC_0000001188270534__b815395872111658">tri_insert_func()</strong>:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188270534__screen1899497294"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">DROP</span><span class="w"> </span><span class="k">FUNCTION</span><span class="w"> </span><span class="k">IF</span><span class="w"> </span><span class="k">EXISTS</span><span class="w"> </span><span class="n">tri_insert_func</span><span class="p">;</span>
<span class="k">CREATE</span><span class="w"> </span><span class="k">OR</span><span class="w"> </span><span class="k">REPLACE</span><span class="w"> </span><span class="k">FUNCTION</span><span class="w"> </span><span class="n">tri_insert_func</span><span class="p">()</span><span class="w"> </span><span class="k">RETURNS</span><span class="w"> </span><span class="k">TRIGGER</span><span class="w"> </span><span class="k">AS</span>
<span class="w"> </span><span class="err">$$</span>
<span class="w"> </span><span class="k">DECLARE</span>
<span class="w"> </span><span class="k">BEGIN</span>
<span class="w"> </span><span class="k">INSERT</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">test_trigger_des_tbl</span><span class="w"> </span><span class="k">VALUES</span><span class="p">(</span><span class="k">NEW</span><span class="p">.</span><span class="n">id1</span><span class="p">,</span><span class="w"> </span><span class="k">NEW</span><span class="p">.</span><span class="n">id2</span><span class="p">,</span><span class="w"> </span><span class="k">NEW</span><span class="p">.</span><span class="n">id3</span><span class="p">);</span>
<span class="w"> </span><span class="k">RETURN</span><span class="w"> </span><span class="k">NEW</span><span class="p">;</span>
<span class="w"> </span><span class="k">END</span>
<span class="w"> </span><span class="err">$$</span><span class="w"> </span><span class="k">LANGUAGE</span><span class="w"> </span><span class="n">PLPGSQL</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001188270534__p490174919293">Create an <strong id="EN-US_TOPIC_0000001188270534__b1350449129111658">INSERT</strong> trigger:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188270534__screen1390164912299"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">CREATE</span><span class="w"> </span><span class="k">TRIGGER</span><span class="w"> </span><span class="n">insert_trigger</span>
<span class="w"> </span><span class="k">BEFORE</span><span class="w"> </span><span class="k">INSERT</span><span class="w"> </span><span class="k">ON</span><span class="w"> </span><span class="n">test_trigger_src_tbl</span>
<span class="w"> </span><span class="k">FOR</span><span class="w"> </span><span class="k">EACH</span><span class="w"> </span><span class="k">ROW</span>
<span class="w"> </span><span class="k">EXECUTE</span><span class="w"> </span><span class="k">PROCEDURE</span><span class="w"> </span><span class="n">tri_insert_func</span><span class="p">();</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001188270534__p265461022110">Modified the trigger <strong id="EN-US_TOPIC_0000001188270534__b42132763733610">delete_trigger</strong>.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188270534__screen2353163234"><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">TRIGGER</span><span class="w"> </span><span class="n">insert_trigger</span><span class="w"> </span><span class="k">ON</span><span class="w"> </span><span class="n">test_trigger_src_tbl</span><span class="w"> </span><span class="k">RENAME</span><span class="w"> </span><span class="k">TO</span><span class="w"> </span><span class="n">insert_trigger_renamed</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001188270534__p56541103211">Disable the trigger <strong id="EN-US_TOPIC_0000001188270534__b187322764533610">insert_trigger</strong>.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188270534__screen156901714231"><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">TABLE</span><span class="w"> </span><span class="n">test_trigger_src_tbl</span><span class="w"> </span><span class="n">DISABLE</span><span class="w"> </span><span class="k">TRIGGER</span><span class="w"> </span><span class="n">insert_trigger_renamed</span><span class="p">;</span><span class="w"> </span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001188270534__p1165441018215">Disable all triggers on the <strong id="EN-US_TOPIC_0000001188270534__b125683314933610">test_trigger_src_tbl</strong> table.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188270534__screen149051232102214"><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">TABLE</span><span class="w"> </span><span class="n">test_trigger_src_tbl</span><span class="w"> </span><span class="n">DISABLE</span><span class="w"> </span><span class="k">TRIGGER</span><span class="w"> </span><span class="k">ALL</span><span class="p">;</span><span class="w"> </span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001188270534__s56e26682f0c24a8987ba07e3099ff0a9"><h4 class="sectiontitle">Helpful Links</h4><p id="EN-US_TOPIC_0000001188270534__a97753a2696fd49538504b71c38f5bece"><a href="dws_06_0184.html">CREATE TRIGGER</a>, <a href="dws_06_0212.html">DROP TRIGGER</a>, <a href="dws_06_0142.html">ALTER TABLE</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