vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/dws/dev/dws_06_0132.html
Lu, Huayi a24ca60074 DWS DEVELOPER 811 version 
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: Lu, Huayi <luhuayi@huawei.com>
Co-committed-by: Lu, Huayi <luhuayi@huawei.com>
2023-01-19 13:37:49 +00:00

99 lines
17 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001098990968"></a><a name="EN-US_TOPIC_0000001098990968"></a>
<h1 class="topictitle1">ALTER REDACTION POLICY</h1>
<div id="body0000001125199825"><div class="section" id="EN-US_TOPIC_0000001098990968__se1c3f486ddc249bf88a6665ebb1755f8"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0000001098990968__a2252e8d6585640c2a961739f92bab925"><strong id="EN-US_TOPIC_0000001098990968__b69811711142210">ALTER REDACTION POLICY</strong> modifies a data redaction policy applied to a specified table.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001098990968__s45e5bcb791ea44aea14d5f73d6f0f95c"><h4 class="sectiontitle">Precautions</h4><p id="EN-US_TOPIC_0000001098990968__ab968098694574d398abccd639f568bbf">Only the owner of the table to which the redaction policy is applied has the permission to modify the redaction policy.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001098990968__sb962574e3aca4aa293b4b146573d5cda"><h4 class="sectiontitle">Syntax</h4><ul id="EN-US_TOPIC_0000001098990968__ul15566184614483"><li id="EN-US_TOPIC_0000001098990968__li1156617465480">Modify the expression used for a redaction policy to take effect.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001098990968__s5d9fde3fca18406caf398a9d37601b16"><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">REDACTION</span><span class="w"> </span><span class="n">POLICY</span><span class="w"> </span><span class="n">policy_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">WHEN</span><span class="w"> </span><span class="p">(</span><span class="n">new_when_expression</span><span class="p">);</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</li></ul>
</div>
<ul id="EN-US_TOPIC_0000001098990968__ul1116710119492"><li id="EN-US_TOPIC_0000001098990968__li581617145014">Enable or disable a redaction policy.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001098990968__screen1126317351508"><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">REDACTION</span><span class="w"> </span><span class="n">POLICY</span><span class="w"> </span><span class="n">policy_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="n">ENABLE</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">DISABLE</span><span class="p">;</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001098990968__li2627137135016">Rename a redaction policy.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001098990968__screen1517125135115"><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">REDACTION</span><span class="w"> </span><span class="n">POLICY</span><span class="w"> </span><span class="n">policy_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_policy_name</span><span class="p">;</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001098990968__li916771113492">Add, modify, or delete a column on which the redaction policy is used.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001098990968__screen153101011155014"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">ALTER</span><span class="w"> </span><span class="n">REDACTION</span><span class="w"> </span><span class="n">POLICY</span><span class="w"> </span><span class="n">policy_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="w"> </span><span class="n">action</span><span class="p">;</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001098990968__p9561113154812">There are several clauses of <strong id="EN-US_TOPIC_0000001098990968__b84235270611209">action</strong>:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001098990968__screen159517518497"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">ADD</span><span class="w"> </span><span class="k">COLUMN</span><span class="w"> </span><span class="k">column_name</span><span class="w"> </span><span class="k">WITH</span><span class="w"> </span><span class="n">function_name</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="n">arguments</span><span class="w"> </span><span class="p">)</span><span class="w"></span>
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">MODIFY</span><span class="w"> </span><span class="k">COLUMN</span><span class="w"> </span><span class="k">column_name</span><span class="w"> </span><span class="k">WITH</span><span class="w"> </span><span class="n">function_name</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="n">arguments</span><span class="w"> </span><span class="p">)</span><span class="w"></span>
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">DROP</span><span class="w"> </span><span class="k">COLUMN</span><span class="w"> </span><span class="k">column_name</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</li></ul>
<div class="section" id="EN-US_TOPIC_0000001098990968__section328515545337"><h4 class="sectiontitle">Parameter Description</h4><ul id="EN-US_TOPIC_0000001098990968__ul10595352457"><li id="EN-US_TOPIC_0000001098990968__lfde7b0ce8c3c4a5db0f3b2fc758835d7"><strong id="EN-US_TOPIC_0000001098990968__b184593198556">policy_name</strong><p id="EN-US_TOPIC_0000001098990968__p119651650115511">Specifies the name of the redaction policy to be modified.</p>
</li><li id="EN-US_TOPIC_0000001098990968__li79943210555"><strong id="EN-US_TOPIC_0000001098990968__b19519104395516">table_name</strong><p id="EN-US_TOPIC_0000001098990968__p198284885610">Specifies the name of the table to which the redaction policy is applied.</p>
</li><li id="EN-US_TOPIC_0000001098990968__li4869182475513"><strong id="EN-US_TOPIC_0000001098990968__b1454154611557">new_when_expression</strong><p id="EN-US_TOPIC_0000001098990968__p1437514117585">Specifies the new expression used for the redaction policy to take effect.</p>
</li><li id="EN-US_TOPIC_0000001098990968__li1481192311562"><strong id="EN-US_TOPIC_0000001098990968__b8744152545811">ENABLE | DISABLE</strong><p id="EN-US_TOPIC_0000001098990968__p8759253195816">Specifies whether to enable or disable the current redaction policy.</p>
<ul id="EN-US_TOPIC_0000001098990968__ul1234983712013"><li id="EN-US_TOPIC_0000001098990968__li128819351403">ENABLE<p id="EN-US_TOPIC_0000001098990968__p175297472006"><a name="EN-US_TOPIC_0000001098990968__li128819351403"></a><a name="li128819351403"></a>Enables the redaction policy that was previously disabled for the table.</p>
</li><li id="EN-US_TOPIC_0000001098990968__li1384013401205">DISABLE<p id="EN-US_TOPIC_0000001098990968__p124801344113"><a name="EN-US_TOPIC_0000001098990968__li1384013401205"></a><a name="li1384013401205"></a>Disables the redaction policy currently applied to the table.</p>
</li></ul>
</li><li id="EN-US_TOPIC_0000001098990968__li1876233412565"><strong id="EN-US_TOPIC_0000001098990968__b5682128155818">new_policy_name</strong><p id="EN-US_TOPIC_0000001098990968__p13360153512112">Specifies the new name of the redaction policy.</p>
</li><li id="EN-US_TOPIC_0000001098990968__li3325154215616"><strong id="EN-US_TOPIC_0000001098990968__b244213015814">column_name</strong><p id="EN-US_TOPIC_0000001098990968__p121701225332">Specifies the name of the table column to which the redaction policy is applied.</p>
<p id="EN-US_TOPIC_0000001098990968__p877813271522">To add a column, use a column name that has not been bound to any redaction functions.</p>
<p id="EN-US_TOPIC_0000001098990968__p75438498320">To modify a column, use the name of an existing column.</p>
<p id="EN-US_TOPIC_0000001098990968__p91101551644">To delete a column, use the name of an existing column.</p>
</li><li id="EN-US_TOPIC_0000001098990968__li390665017567"><strong id="EN-US_TOPIC_0000001098990968__b18518123515813">function_name</strong><p id="EN-US_TOPIC_0000001098990968__p144512411251">Specifies the name of a redaction function.</p>
</li><li id="EN-US_TOPIC_0000001098990968__li85969520517"><strong id="EN-US_TOPIC_0000001098990968__b13590193705818">arguments</strong><p id="EN-US_TOPIC_0000001098990968__p45961452055">Specifies the list of arguments of the redaction function.</p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001098990968__section1614144915295"><h4 class="sectiontitle">Examples</h4><p id="EN-US_TOPIC_0000001098990968__p650211413919">Modify the expression for the data redaction policy to take effect for all users.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001098990968__screen81311811174119"><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">REDACTION</span><span class="w"> </span><span class="n">POLICY</span><span class="w"> </span><span class="n">mask_emp</span><span class="w"> </span><span class="k">ON</span><span class="w"> </span><span class="n">emp</span><span class="w"> </span><span class="k">WHEN</span><span class="w"> </span><span class="p">(</span><span class="mi">1</span><span class="o">=</span><span class="mi">1</span><span class="p">);</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001098990968__p13501191415393">Disable the redaction policy.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001098990968__screen14951629124115"><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">REDACTION</span><span class="w"> </span><span class="n">POLICY</span><span class="w"> </span><span class="n">mask_emp</span><span class="w"> </span><span class="k">ON</span><span class="w"> </span><span class="n">emp</span><span class="w"> </span><span class="n">DISABLE</span><span class="p">;</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001098990968__p1350191433912">Enable the redaction policy again.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001098990968__screen962018116424"><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">REDACTION</span><span class="w"> </span><span class="n">POLICY</span><span class="w"> </span><span class="n">mask_emp</span><span class="w"> </span><span class="k">ON</span><span class="w"> </span><span class="n">emp</span><span class="w"> </span><span class="n">ENABLE</span><span class="p">;</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001098990968__p55013148393">Change the redaction policy name to <strong id="EN-US_TOPIC_0000001098990968__b2561172419010">mask_emp_new</strong>.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001098990968__screen17571514219"><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">REDACTION</span><span class="w"> </span><span class="n">POLICY</span><span class="w"> </span><span class="n">mask_emp</span><span class="w"> </span><span class="k">ON</span><span class="w"> </span><span class="n">emp</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">mask_emp_new</span><span class="p">;</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001098990968__p3501614153914">Add a column with the redaction policy used.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001098990968__screen59251628144216"><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">REDACTION</span><span class="w"> </span><span class="n">POLICY</span><span class="w"> </span><span class="n">mask_emp_new</span><span class="w"> </span><span class="k">ON</span><span class="w"> </span><span class="n">emp</span><span class="w"> </span><span class="k">ADD</span><span class="w"> </span><span class="k">COLUMN</span><span class="w"> </span><span class="n">name</span><span class="w"> </span><span class="k">WITH</span><span class="w"> </span><span class="n">mask_partial</span><span class="p">(</span><span class="n">name</span><span class="p">,</span><span class="w"> </span><span class="s1">'*'</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="k">length</span><span class="p">(</span><span class="n">name</span><span class="p">));</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001098990968__p45001814183915">Modify the redaction policy for the <strong id="EN-US_TOPIC_0000001098990968__b33501754208">name</strong> column. Use the <strong id="EN-US_TOPIC_0000001098990968__b035035414020">MASK_FULL</strong> function to redact all data in the <strong id="EN-US_TOPIC_0000001098990968__b635195413013">name</strong> column.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001098990968__screen1331944654219"><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">REDACTION</span><span class="w"> </span><span class="n">POLICY</span><span class="w"> </span><span class="n">mask_emp_new</span><span class="w"> </span><span class="k">ON</span><span class="w"> </span><span class="n">emp</span><span class="w"> </span><span class="k">MODIFY</span><span class="w"> </span><span class="k">COLUMN</span><span class="w"> </span><span class="n">name</span><span class="w"> </span><span class="k">WITH</span><span class="w"> </span><span class="n">mask_full</span><span class="p">(</span><span class="n">name</span><span class="p">);</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001098990968__p1949961413391">Delete an existing column where the redaction policy is used.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001098990968__screen4466195413424"><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">REDACTION</span><span class="w"> </span><span class="n">POLICY</span><span class="w"> </span><span class="n">mask_emp_new</span><span class="w"> </span><span class="k">ON</span><span class="w"> </span><span class="n">emp</span><span class="w"> </span><span class="k">DROP</span><span class="w"> </span><span class="k">COLUMN</span><span class="w"> </span><span class="n">name</span><span class="p">;</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001098990968__section1426016489355"><h4 class="sectiontitle">Helpful Links</h4><p id="EN-US_TOPIC_0000001098990968__p9325125517354"><a href="dws_06_0168.html">CREATE REDACTION POLICY</a>, <a href="dws_06_0199.html">DROP REDACTION POLICY</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