forked from docs/doc-exports
Lu, Huayi
e6fa411af0
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>
79 lines
17 KiB
HTML
79 lines
17 KiB
HTML
<a name="EN-US_TOPIC_0000001233628591"></a><a name="EN-US_TOPIC_0000001233628591"></a>
|
|
|
|
<h1 class="topictitle1">SET</h1>
|
|
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0000001233628591__s322ae74a9d4b4206b10e4d6cb6d41c2f"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0000001233628591__ab4e140402fa24b6ab6cd4994c785b87c"><strong id="EN-US_TOPIC_0000001233628591__b11122153142133">SET</strong> modifies a run-time parameter.</p>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000001233628591__sf1326ff754364d7f9e9aee5b07be97c7"><h4 class="sectiontitle">Precautions</h4><p id="EN-US_TOPIC_0000001233628591__a58feda383efc43108f902e4377b906c1">Most run-time parameters can be modified by executing <strong id="EN-US_TOPIC_0000001233628591__b141802531817">SET</strong>. Some parameters cannot be modified after a server or session starts.</p>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000001233628591__sea7eeaeb4d5846729e55549acc643fea"><h4 class="sectiontitle">Syntax</h4><ul id="EN-US_TOPIC_0000001233628591__u4c2d24ab0a6545e6ab5aa24096cbe679"><li id="EN-US_TOPIC_0000001233628591__l2396d14b3c3e4aaab78a0ccbd0ea8666">Set the system time zone.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628591__s2c919d5bfacb4cfd92f04c4bd6d37e64"><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">SET</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="k">SESSION</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">LOCAL</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="k">TIME</span><span class="w"> </span><span class="k">ZONE</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="n">timezone</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">LOCAL</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">DEFAULT</span><span class="w"> </span><span class="err">}</span><span class="p">;</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
</li><li id="EN-US_TOPIC_0000001233628591__l996f039669e14295b25fd80ed04e7bfb">Set the schema of the table.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628591__s6be1a1c65b6d464691b8c95617781361"><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">SET</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="k">SESSION</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">LOCAL</span><span class="w"> </span><span class="p">]</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="err">{</span><span class="n">CURRENT_SCHEMA</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="k">TO</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="err">}</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="k">schema</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">DEFAULT</span><span class="w"> </span><span class="err">}</span>
|
|
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">SCHEMA</span><span class="w"> </span><span class="s1">'schema'</span><span class="err">}</span><span class="p">;</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
</li><li id="EN-US_TOPIC_0000001233628591__lab618fd3256e4359900c4060ab7e1a09">Set client encoding.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628591__s9ffb5ad023ec4f79bc65e52935e60f0b"><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">SET</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="k">SESSION</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">LOCAL</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="k">NAMES</span><span class="w"> </span><span class="n">encoding_name</span><span class="p">;</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
</li><li id="EN-US_TOPIC_0000001233628591__lf1dc7a0c1d114454b52edb75133e80e4">Set XML parsing mode.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628591__sd5aeaabe7b374be29c8e6ebc858f5bdb"><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">SET</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="k">SESSION</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">LOCAL</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="n">XML</span><span class="w"> </span><span class="k">OPTION</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="n">DOCUMENT</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">CONTENT</span><span class="w"> </span><span class="err">}</span><span class="p">;</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
</li><li id="EN-US_TOPIC_0000001233628591__la459b87bf7584cddbd0134dc001b9a36">Set other running parameters.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628591__s64f5fda840234e66ae639398c2d0c545"><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">SET</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="k">LOCAL</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">SESSION</span><span class="w"> </span><span class="p">]</span>
|
|
<span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="err">{</span><span class="n">config_parameter</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="k">TO</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="err">}</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="n">value</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">DEFAULT</span><span class="w"> </span><span class="err">}</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">CURRENT</span><span class="w"> </span><span class="err">}}}</span><span class="p">;</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000001233628591__se8530cae21fd4932a87b96aedaebc0a9"><h4 class="sectiontitle">Parameter Description</h4><ul id="EN-US_TOPIC_0000001233628591__uaef51370c2e94ba5ad424d790db475df"><li id="EN-US_TOPIC_0000001233628591__ld65b9af41f26448bbf29330fa8be13ae"><strong id="EN-US_TOPIC_0000001233628591__a0c502c453b9a4f43bba4ccbde47534c0">SESSION</strong><p id="EN-US_TOPIC_0000001233628591__a9942dfc426bd497eb76bfef4505cd053">Indicates that the specified parameters take effect for the current session. This is the default value if neither <strong id="EN-US_TOPIC_0000001233628591__en-us_topic_0058966091_b47168746181550">SESSION</strong> nor <strong id="EN-US_TOPIC_0000001233628591__en-us_topic_0058966091_b21865537181550">LOCAL</strong> appears.</p>
|
|
<p id="EN-US_TOPIC_0000001233628591__a2015b612098943e79d706d69b0ca68ec">If <strong id="EN-US_TOPIC_0000001233628591__b35886909142133">SET</strong> or <strong id="EN-US_TOPIC_0000001233628591__b54546729142133">SET SESSION</strong> is executed within a transaction that is later aborted, the effects of the <strong id="EN-US_TOPIC_0000001233628591__b21158517142133">SET</strong> command disappear when the transaction is rolled back. Once the surrounding transaction is committed, the effects will persist until the end of the session, unless overridden by another <strong id="EN-US_TOPIC_0000001233628591__b56208930142133">SET</strong>.</p>
|
|
</li><li id="EN-US_TOPIC_0000001233628591__lc54916913de14932b3a59a6d2d62253a"><strong id="EN-US_TOPIC_0000001233628591__ac878f676d7914c29bd0da3a035bb504b">LOCAL</strong><p id="EN-US_TOPIC_0000001233628591__a3ef1d3a108cc400f887b6dd3c100c11e">Indicates that the specified parameters take effect for the current transaction. After <strong id="EN-US_TOPIC_0000001233628591__b55115693181550">COMMIT</strong> or <strong id="EN-US_TOPIC_0000001233628591__b26279195181550">ROLLBACK</strong>, the session-level setting takes effect again.</p>
|
|
<p id="EN-US_TOPIC_0000001233628591__ae21f4110649946259598961dc651e089">The effects of <strong id="EN-US_TOPIC_0000001233628591__b23588111142133">SET LOCAL</strong> last only till the end of the current transaction, whether committed or not. A special case is <strong id="EN-US_TOPIC_0000001233628591__b10966409142133">SET</strong> followed by <strong id="EN-US_TOPIC_0000001233628591__b31588818142133">SET LOCAL</strong> within a single transaction: the <strong id="EN-US_TOPIC_0000001233628591__b15863907142133">SET LOCAL</strong> value will be seen until the end of the transaction, but afterwards (if the transaction is committed) the <strong id="EN-US_TOPIC_0000001233628591__b8557437142133">SET</strong> value will take effect.</p>
|
|
</li><li id="EN-US_TOPIC_0000001233628591__leeb7d19987ab4946ac17f92144a612d0"><strong id="EN-US_TOPIC_0000001233628591__a15b39046fdf2417c898d01be5f45574f">TIME ZONE timezone</strong><p id="EN-US_TOPIC_0000001233628591__acaaf7f048bec4354a6b2a2eb945b7359">Indicates the local time zone for the current session.</p>
|
|
<p id="EN-US_TOPIC_0000001233628591__a1fc2504fe345415a8fafea6348a80f41">Value range: A valid local time zone. The corresponding run-time parameter is <strong id="EN-US_TOPIC_0000001233628591__en-us_topic_0058966091_b17128889181550">TimeZone</strong>. The default value is <strong id="EN-US_TOPIC_0000001233628591__b842352706213028">PRC</strong>.</p>
|
|
</li><li id="EN-US_TOPIC_0000001233628591__lf8fede1df65341a6bdf1ca72054ae1b5"><strong id="EN-US_TOPIC_0000001233628591__a76c688f0a800438f8eb3a6a1a9c484c6">CURRENT_SCHEMA</strong><p id="EN-US_TOPIC_0000001233628591__a2293d34156464d70870c58285f813f54"><strong id="EN-US_TOPIC_0000001233628591__a1bd28728cfc3471c89ba56f52a3b5b78">schema</strong></p>
|
|
<p id="EN-US_TOPIC_0000001233628591__a2a80039f78b546d180a0ec9dc54611ff">Indicates the current schema.</p>
|
|
<p id="EN-US_TOPIC_0000001233628591__a8c062f091e2b496087978383add05be6">Value range: An existing schema name.</p>
|
|
</li><li id="EN-US_TOPIC_0000001233628591__l63483e54edaa458894ff7619bd3cbd0d"><strong id="EN-US_TOPIC_0000001233628591__a2637ea846f064755a4c2097a5ddeec91">SCHEMA schema</strong><p id="EN-US_TOPIC_0000001233628591__ac830ab894acc442e8932330b9faa0d07">Indicates the current schema. Here the schema is a string.</p>
|
|
<p id="EN-US_TOPIC_0000001233628591__a44e32318da5c4682a2b08e95148d7b9b">Example: set schema 'public';</p>
|
|
</li><li id="EN-US_TOPIC_0000001233628591__lf94a02aa3d774d639fad101cbc7aa358"><strong id="EN-US_TOPIC_0000001233628591__a50d01f392eca439d8a67f97f2384b4f2">NAMES encoding_name</strong><p id="EN-US_TOPIC_0000001233628591__a276c75e1746a49139802fc6cb36c0fa9">Indicates the client character encoding name. This command is equivalent to <strong id="EN-US_TOPIC_0000001233628591__b40753933181550">set client_encoding to encoding_name</strong>.</p>
|
|
<p id="EN-US_TOPIC_0000001233628591__a2bd2df70f3694afaa46a425a0f3af6c8">Value range: A valid character encoding name. The run-time parameter corresponding to this option is <strong id="EN-US_TOPIC_0000001233628591__b47499760181550">client_encoding</strong>. The default encoding is <strong id="EN-US_TOPIC_0000001233628591__b24844657181550">UTF8</strong>.</p>
|
|
</li><li id="EN-US_TOPIC_0000001233628591__l2f8c73b884ac49b0a520091637b134a6"><strong id="EN-US_TOPIC_0000001233628591__a863e38dde47c4b15b512c77d81e6ac4f">XML OPTION option</strong><p id="EN-US_TOPIC_0000001233628591__a0d698c5ebaef4f1289c663c1eb087e74">Indicates the XML resolution mode.</p>
|
|
<p id="EN-US_TOPIC_0000001233628591__aa4856683df67450aa3cf07022a3dc3c8">Value range: <strong id="EN-US_TOPIC_0000001233628591__b842352706192047">CONTENT</strong> (default), <strong id="EN-US_TOPIC_0000001233628591__b842352706192055">DOCUMENT</strong></p>
|
|
</li><li id="EN-US_TOPIC_0000001233628591__lbaf981aced3246faa389d671a78e6963"><strong id="EN-US_TOPIC_0000001233628591__a0e80736ca13c4261b8ddf9cba22fefd9">config_parameter</strong><p id="EN-US_TOPIC_0000001233628591__ab003c4b5277140e091ac396112e16b6d">Indicates the configurable run-time parameters. You can use <strong id="EN-US_TOPIC_0000001233628591__b3413006914287">SHOW ALL</strong> to view available run-time parameters.</p>
|
|
<div class="note" id="EN-US_TOPIC_0000001233628591__nef4970e499f644de8aeb492b47cee4fe"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001233628591__a1f0a0e82e34144d9b5bea5c4e42fbf47">Some parameters that viewed by <strong id="EN-US_TOPIC_0000001233628591__b9614895181550">SHOW ALL</strong> cannot be set by <strong id="EN-US_TOPIC_0000001233628591__b19425192181550">SET</strong>. For example, <strong id="EN-US_TOPIC_0000001233628591__b166523981033422">max_datanodes</strong>.</p>
|
|
</div></div>
|
|
</li><li id="EN-US_TOPIC_0000001233628591__l947dfa92bd044f259b7b730c2ac35cad"><strong id="EN-US_TOPIC_0000001233628591__ae5e4910cff034d1f82227ef97023aba7">value</strong><p id="EN-US_TOPIC_0000001233628591__a568d104888e149649c802ead5a9607df">Indicates the new value of the <strong id="EN-US_TOPIC_0000001233628591__b842352706183920">config_parameter</strong> parameter. This parameter can be specified as string constants, identifiers, numbers, or comma-separated lists of these. <strong id="EN-US_TOPIC_0000001233628591__b56719981181550">DEFAULT</strong> can be written to indicate resetting the parameter to its default value.</p>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000001233628591__s0ff0c99a2a854b31a1c7e4220acbfa44"><h4 class="sectiontitle">Examples</h4><p id="EN-US_TOPIC_0000001233628591__p28826156123">Configure the search path of the <strong id="EN-US_TOPIC_0000001233628591__b79360045833422">tpcds</strong> schema:</p>
|
|
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628591__screen0254105719124"><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">SET</span><span class="w"> </span><span class="n">search_path</span><span class="w"> </span><span class="k">TO</span><span class="w"> </span><span class="n">tpcds</span><span class="p">,</span><span class="w"> </span><span class="k">public</span><span class="p">;</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
<p id="EN-US_TOPIC_0000001233628591__p128821615141216">Set the date style to the traditional POSTGRES style (date placed before month):</p>
|
|
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628591__screen1235811541310"><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">SET</span><span class="w"> </span><span class="n">datestyle</span><span class="w"> </span><span class="k">TO</span><span class="w"> </span><span class="n">postgres</span><span class="p">;</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000001233628591__s2caee5ae7b6f4fb38cb21caaada08d6c"><h4 class="sectiontitle">Helpful Links</h4><p id="EN-US_TOPIC_0000001233628591__a2ce5d1a9dae144a4aef1a6d176c84937"><a href="dws_06_0219.html">RESET</a>, <a href="dws_06_0224.html">SHOW</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>
|
|
|