vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/dli/sqlreference/dli_08_0082.html
Su, Xiaomeng 76a5b1ee83 dli_sqlreference_20240227 
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Co-authored-by: Su, Xiaomeng <suxiaomeng1@huawei.com>
Co-committed-by: Su, Xiaomeng <suxiaomeng1@huawei.com>
2024-03-27 22:02:33 +00:00

57 lines
6.8 KiB
HTML
Raw Blame History

<a name="dli_08_0082"></a><a name="dli_08_0082"></a>
<h1 class="topictitle1">Renaming a Partition (Only OBS Tables Supported)</h1>
<div id="body8662426"><div class="section" id="dli_08_0082__en-us_topic_0114776176_en-us_topic_0093946763_sf12663707c5545bb8e56a03b3891776b"><h4 class="sectiontitle">Function</h4><p id="dli_08_0082__en-us_topic_0114776176_en-us_topic_0093946763_a705e88ec45d6417e9856cb9288c4e4c8">This statement is used to rename partitions.</p>
</div>
<div class="section" id="dli_08_0082__en-us_topic_0114776176_en-us_topic_0093946763_s271280576a7c431494b560860731492d"><h4 class="sectiontitle">Syntax</h4><div class="codecoloring" codetype="Sql" id="dli_08_0082__en-us_topic_0114776176_screen109564282306"><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">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="n">PARTITION</span><span class="w"> </span><span class="n">partition_specs</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">PARTITION</span><span class="w"> </span><span class="n">partition_specs</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="dli_08_0082__en-us_topic_0114776176_en-us_topic_0093946763_s4722556def8545d097cf905b9261c45d"><h4 class="sectiontitle">Keywords</h4><ul id="dli_08_0082__ul48718578292"><li id="dli_08_0082__li4871155782917">PARTITION: a specified partition</li><li id="dli_08_0082__li1287105772917">RENAME: new name of the partition</li></ul>
</div>
<div class="section" id="dli_08_0082__en-us_topic_0114776188_en-us_topic_0093946905_s95436b2cebbc4c34b0e6ca8427d4f1d9"><h4 class="sectiontitle">Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0082__en-us_topic_0114776188_en-us_topic_0103084433_t2fa8597e0dde4884bd6412ac207ebea8" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters</caption><thead align="left"><tr id="dli_08_0082__en-us_topic_0114776188_en-us_topic_0103084433_r16c75fd8fdbf41c79f9aee82b032351c"><th align="left" class="cellrowborder" valign="top" width="19.689999999999998%" id="mcps1.3.4.2.2.3.1.1"><p id="dli_08_0082__en-us_topic_0114776188_en-us_topic_0103084433_a9dd69379a3f54904a9c510fb817659ad">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="80.31%" id="mcps1.3.4.2.2.3.1.2"><p id="dli_08_0082__en-us_topic_0114776188_en-us_topic_0103084433_a7ede0d62539542baa7e367cf902bf2b2">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_08_0082__row160712191411"><td class="cellrowborder" valign="top" width="19.689999999999998%" headers="mcps1.3.4.2.2.3.1.1 "><p id="dli_08_0082__p3608320149">table_name</p>
</td>
<td class="cellrowborder" valign="top" width="80.31%" headers="mcps1.3.4.2.2.3.1.2 "><p id="dli_08_0082__p160812219141">Table name</p>
</td>
</tr>
<tr id="dli_08_0082__row173647290145"><td class="cellrowborder" valign="top" width="19.689999999999998%" headers="mcps1.3.4.2.2.3.1.1 "><p id="dli_08_0082__p123641229111418">partition_specs</p>
</td>
<td class="cellrowborder" valign="top" width="80.31%" headers="mcps1.3.4.2.2.3.1.2 "><p id="dli_08_0082__p636492981417">Partition fields</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="dli_08_0082__en-us_topic_0114776176_en-us_topic_0093946763_sc97eaa214c354184a467729a278cfc48"><h4 class="sectiontitle">Precautions</h4><ul id="dli_08_0082__en-us_topic_0114776176_en-us_topic_0093946763_u7bf2b5d74413455b9ef844810d848563"><li id="dli_08_0082__li6647606105"><strong id="dli_08_0082__b138317412549">This statement is used for OBS table operations.</strong></li><li id="dli_08_0082__en-us_topic_0114776176_en-us_topic_0093946763_l45b49b239c3b4d71aea62e2fca6c4fc6">The table and partition to be renamed must exist. Otherwise, an error occurs. The name of the new partition must be unique. Otherwise, an error occurs.</li><li id="dli_08_0082__en-us_topic_0114776176_en-us_topic_0093946763_le1ffcd15c9474f47a36d4512733682d6">If a table is partitioned using multiple fields, you are required to specify all the fields of a partition (at random order) when renaming the partition. </li><li id="dli_08_0082__en-us_topic_0114776176_li3299546133216">By default, the <span class="parmname" id="dli_08_0082__parmname5229104912119"><b>partition_specs</b></span> parameter contains <strong id="dli_08_0082__b923054961110">()</strong>. For example: <b><span class="cmdname" id="dli_08_0082__en-us_topic_0114776176_cmdname1398714673114">PARTITION (dt='2009-09-09',city='xxx')</span></b></li></ul>
</div>
<div class="section" id="dli_08_0082__en-us_topic_0114776176_en-us_topic_0093946763_sbcca99e00ec94768b85d892d911b5d47"><h4 class="sectiontitle">Example</h4><p id="dli_08_0082__en-us_topic_0114776176_en-us_topic_0093946763_a247970fb6fb74623b4e11ac37837e288">To modify the name of the <strong id="dli_08_0082__b1119265310115">city='xxx',dt='2008-08-08'</strong> partition in the <strong id="dli_08_0082__b1019235318114">student</strong> table to <strong id="dli_08_0082__b131921353101111">city='xxx',dt='2009-09-09'</strong>, run the following statement: </p>
<div class="codecoloring" codetype="Sql" id="dli_08_0082__en-us_topic_0114776176_screen7301118103117"><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">ALTER</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">student</span>
<span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="p">(</span><span class="n">city</span><span class="o">=</span><span class="s1">'xxx'</span><span class="p">,</span><span class="n">dt</span><span class="o">=</span><span class="s1">'2008-08-08'</span><span class="p">)</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">PARTITION</span><span class="w"> </span><span class="p">(</span><span class="n">city</span><span class="o">=</span><span class="s1">'xxx'</span><span class="p">,</span><span class="n">dt</span><span class="o">=</span><span class="s1">'2009-09-09'</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dli_08_0080.html">Syntax for Partitioning a Table</a></div>
</div>
</div>
View Git Blame Copy Permalink