doc-exports/docs/dws/dev/dws_06_0053.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

47 lines
5.1 KiB
HTML

<a name="EN-US_TOPIC_0000001145830535"></a><a name="EN-US_TOPIC_0000001145830535"></a>
<h1 class="topictitle1">Configuration Settings Functions</h1>
<div id="body1553151203303"><p id="EN-US_TOPIC_0000001145830535__ad6d64ad88a554c0fb7bbe8f44e4af493">Configuration setting functions are used for querying and modifying configuration parameters during running.</p>
<ul id="EN-US_TOPIC_0000001145830535__uc80a3be337844b9f8ae9c9e827ba80a0"><li id="EN-US_TOPIC_0000001145830535__l07be723295314a889063297df778a83d">current_setting(setting_name)<p id="EN-US_TOPIC_0000001145830535__a42901c1a8d324e1dbf3eea8d6a15f6fd"><a name="EN-US_TOPIC_0000001145830535__l07be723295314a889063297df778a83d"></a><a name="l07be723295314a889063297df778a83d"></a>Description: Specifies the current setting.</p>
<p id="EN-US_TOPIC_0000001145830535__a5e3538887a5741d6ba5670eec8b3a0c6">Return type: text</p>
<p id="EN-US_TOPIC_0000001145830535__aab042ae114884f368acc61acb61a75a5">Note: <strong id="EN-US_TOPIC_0000001145830535__b175441214125810">current_setting</strong> obtains the current setting of <strong id="EN-US_TOPIC_0000001145830535__b1545114135812">setting_name</strong> by query. It is equivalent to the <strong id="EN-US_TOPIC_0000001145830535__b84235270617917">SHOW</strong> statement. For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001145830535__s36b5b281b6bb4586808482f9d98a0912"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">current_setting</span><span class="p">(</span><span class="s1">'datestyle'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">current_setting</span><span class="w"></span>
<span class="c1">-----------------</span>
<span class="w"> </span><span class="n">ISO</span><span class="p">,</span><span class="w"> </span><span class="n">MDY</span><span class="w"></span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001145830535__l400e83450c904c0c8440f7d034f96084">set_config(setting_name, new_value, is_local)<p id="EN-US_TOPIC_0000001145830535__afc9936a0fc5a407d9f891cfaf54df123"><a name="EN-US_TOPIC_0000001145830535__l400e83450c904c0c8440f7d034f96084"></a><a name="l400e83450c904c0c8440f7d034f96084"></a>Description: Sets the parameter and returns a new value.</p>
<p id="EN-US_TOPIC_0000001145830535__a9eb6cd963e0f4ce4a6a892adcb5a59f8">Return type: text</p>
<p id="EN-US_TOPIC_0000001145830535__acc0d83ebf90e4642b66da1d3a9e3a8fc">Note: <strong id="EN-US_TOPIC_0000001145830535__a6a9fd082e44c4541a80b043f6bd396a3">set_config</strong> sets the parameter <strong id="EN-US_TOPIC_0000001145830535__a3f63b00d5c404700954cad2937fd61de">setting_name</strong> to <strong id="EN-US_TOPIC_0000001145830535__a463fc5373f294a8e90961e9af58784cc">new_value</strong>. If <strong id="EN-US_TOPIC_0000001145830535__a0975c43019fc400f92dc90233abed677">is_local</strong> is <strong id="EN-US_TOPIC_0000001145830535__a510a17b2636a4de6808340ce77a9a4b4">true</strong>, the new value will only apply to the current transaction. If you want the new value to apply for the current session, use <strong id="EN-US_TOPIC_0000001145830535__a91fe19f8a8654f808ae45b7c9dd721c2">false</strong> instead. The function corresponds to the <strong id="EN-US_TOPIC_0000001145830535__a249066f7f5454f148327f587bceef133">SET</strong> statement. For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001145830535__sd80a534eb2b146d6922b0548342a01b5"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">set_config</span><span class="p">(</span><span class="s1">'log_statement_stats'</span><span class="p">,</span><span class="w"> </span><span class="s1">'off'</span><span class="p">,</span><span class="w"> </span><span class="k">false</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">set_config</span><span class="w"></span>
<span class="c1">------------</span>
<span class="w"> </span><span class="k">off</span><span class="w"></span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</li></ul>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_06_0052.html">System Administration Functions</a></div>
</div>
</div>