vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/dws/dev/dws_06_0276.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

68 lines
8.1 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001188429090"></a><a name="EN-US_TOPIC_0000001188429090"></a>
<h1 class="topictitle1">RENAME TABLE</h1>
<div id="body0000001200335335"><div class="section" id="EN-US_TOPIC_0000001188429090__section1423713471215"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0000001188429090__p12216105312116"><strong id="EN-US_TOPIC_0000001188429090__b189737250145">RENAME TABLE</strong> renames a specified table.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001188429090__section91041651429"><h4 class="sectiontitle">Precautions</h4><p id="EN-US_TOPIC_0000001188429090__p1183912617218">RENAME TABLE has the same function as the following command:</p>
</div>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188429090__screen69571227224"><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="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_table_name</span>
</pre></div></td></tr></table></div>
</div>
<div class="section" id="EN-US_TOPIC_0000001188429090__section153609422214"><h4 class="sectiontitle">Syntax</h4><div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188429090__screen64618471219"><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">RENAME</span><span class="w"> </span><span class="k">TABLE</span>
<span class="err">{</span><span class="p">[</span><span class="k">schema</span><span class="p">.]</span><span class="k">table_name</span><span class="w"> </span><span class="k">TO</span><span class="w"> </span><span class="n">new_table_name</span><span class="err">}</span><span class="w"> </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_0000001188429090__section537525738"><h4 class="sectiontitle">Parameters</h4><ul id="EN-US_TOPIC_0000001188429090__ul450915385310"><li id="EN-US_TOPIC_0000001188429090__li4509183810312"><strong id="EN-US_TOPIC_0000001188429090__b8648154936">schema</strong><p id="EN-US_TOPIC_0000001188429090__p4962550141117">Specifies the schema name.</p>
</li></ul>
<ul id="EN-US_TOPIC_0000001188429090__ul1989274011317"><li id="EN-US_TOPIC_0000001188429090__li489220401838"><strong id="EN-US_TOPIC_0000001188429090__b921355720319">table_name</strong><p id="EN-US_TOPIC_0000001188429090__p1962650181113">Specifies the name of the table to be modified.</p>
</li></ul>
<ul id="EN-US_TOPIC_0000001188429090__ul1341710431638"><li id="EN-US_TOPIC_0000001188429090__li144174432311"><strong id="EN-US_TOPIC_0000001188429090__b269220110414">new_table_name</strong><p id="EN-US_TOPIC_0000001188429090__p89627504115">Specifies the new table name.</p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001188429090__section59011013642"><h4 class="sectiontitle">Examples</h4><p id="EN-US_TOPIC_0000001188429090__p16833125314542">Create a column-store table and specify the storage format and compression mode:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188429090__screen1215719587599"><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></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">customer_address</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">customer_address</span>
<span class="p">(</span>
<span class="w"> </span><span class="n">ca_address_sk</span><span class="w"> </span><span class="nb">INTEGER</span><span class="w"> </span><span class="k">NOT</span><span class="w"> </span><span class="k">NULL</span><span class="w"> </span><span class="p">,</span>
<span class="w"> </span><span class="n">ca_address_id</span><span class="w"> </span><span class="nb">CHARACTER</span><span class="p">(</span><span class="mi">16</span><span class="p">)</span><span class="w"> </span><span class="k">NOT</span><span class="w"> </span><span class="k">NULL</span><span class="w"> </span><span class="p">,</span>
<span class="w"> </span><span class="n">ca_street_number</span><span class="w"> </span><span class="nb">CHARACTER</span><span class="p">(</span><span class="mi">10</span><span class="p">)</span><span class="w"> </span><span class="p">,</span>
<span class="w"> </span><span class="n">ca_street_name</span><span class="w"> </span><span class="nb">CHARACTER</span><span class="w"> </span><span class="nb">varying</span><span class="p">(</span><span class="mi">60</span><span class="p">)</span><span class="w"> </span><span class="p">,</span>
<span class="w"> </span><span class="n">ca_street_type</span><span class="w"> </span><span class="nb">CHARACTER</span><span class="p">(</span><span class="mi">15</span><span class="p">)</span><span class="w"> </span><span class="p">,</span>
<span class="w"> </span><span class="n">ca_suite_number</span><span class="w"> </span><span class="nb">CHARACTER</span><span class="p">(</span><span class="mi">10</span><span class="p">)</span><span class="w"> </span>
<span class="p">)</span>
<span class="k">WITH</span><span class="w"> </span><span class="p">(</span><span class="n">ORIENTATION</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="k">COLUMN</span><span class="p">,</span><span class="w"> </span><span class="n">COMPRESSION</span><span class="o">=</span><span class="n">HIGH</span><span class="p">,</span><span class="n">COLVERSION</span><span class="o">=</span><span class="mi">2</span><span class="p">.</span><span class="mi">0</span><span class="p">)</span>
<span class="n">DISTRIBUTE</span><span class="w"> </span><span class="k">BY</span><span class="w"> </span><span class="n">HASH</span><span class="w"> </span><span class="p">(</span><span class="n">ca_address_sk</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001188429090__p796285081118">Rename a table:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188429090__screen560384513014"><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">RENAME</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">customer_address</span><span class="w"> </span><span class="k">TO</span><span class="w"> </span><span class="n">new_customer_address</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001188429090__section1272634616417"><h4 class="sectiontitle">Helpful Links</h4><p id="EN-US_TOPIC_0000001188429090__p69621750101112"><a href="dws_06_0177.html">CREATE TABLE</a>, <a href="dws_06_0142.html">ALTER TABLE</a>, and <a href="dws_06_0208.html">DROP 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