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

455 lines
94 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001233510081"></a><a name="EN-US_TOPIC_0000001233510081"></a>
<h1 class="topictitle1">ALTER TABLE PARTITION</h1>
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0000001233510081__s574fd20d632042de9c4b313a4a19cdeb"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0000001233510081__a997a3318de5d48e59b863c1837b5af3f"><strong id="EN-US_TOPIC_0000001233510081__b10633142819296">ALTER TABLE PARTITION</strong> modifies table partitioning, including adding, deleting, splitting, merging partitions, and modifying partition attributes.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001233510081__sb35de472c760440880bf0cac6a2220f5"><h4 class="sectiontitle">Precautions</h4><ul id="EN-US_TOPIC_0000001233510081__ucc6949eba2ce4b7da6aeb633ca432e1c"><li id="EN-US_TOPIC_0000001233510081__lbde1a9fa7d3d442591f009d51332d5c5">The name of the added partition must be different from names of existing partitions in the partitioned table.</li><li id="EN-US_TOPIC_0000001233510081__l18ad259cfe524c988fc6cac03cd95549">For a range partitioned table, the boundary value of the added partition must be the same type as the partition key of the partitioned table. The key value of the added partition must exceed the upper limit of the last partition.</li><li id="EN-US_TOPIC_0000001233510081__li10873323115720">For a list partitioned table, if the DEFAULT partition has been defined, no new partition can be added.</li><li id="EN-US_TOPIC_0000001233510081__li7578205817307">Unless otherwise specified, the syntax of range partitioned tables is the same as that of column-store partitioned tables.</li><li id="EN-US_TOPIC_0000001233510081__lb67d3061f8034e3e9937d83e129d6d5c">If the number of partitions in the target partitioned table has reached the maximum (32767), partitions cannot be added.</li></ul>
<ul id="EN-US_TOPIC_0000001233510081__u4482697f88b94c03aba9ee0eb0d63006"><li id="EN-US_TOPIC_0000001233510081__l49abb0f2442b4b438543fb47597bdedc">If a partitioned table has only one partition, the partition cannot be deleted.</li><li id="EN-US_TOPIC_0000001233510081__li1899834213344">When you run the <strong id="EN-US_TOPIC_0000001233510081__b13850160822029">DROP PARTITION</strong> command to delete a partition, the data in the partition is also deleted.</li><li id="EN-US_TOPIC_0000001233510081__l0896077b4f07435fb9b45720563132a7">Use <strong id="EN-US_TOPIC_0000001233510081__en-us_topic_0058966064_b842352706151526">PARTITION FOR()</strong> to choose partitions. The number of specified values in the brackets should be the same as the column number in customized partition, and they must be consistent.</li><li id="EN-US_TOPIC_0000001233510081__ld980357cd3b04afea60c8d0573b4dc4a">The <strong id="EN-US_TOPIC_0000001233510081__b84235270615928">Value</strong> partitioned table does not support the <strong id="EN-US_TOPIC_0000001233510081__b84235270615923">Alter Partition</strong> operation.</li><li id="EN-US_TOPIC_0000001233510081__li179213288203">For OBS multi-temperature tables:<ul id="EN-US_TOPIC_0000001233510081__ul1316812451673"><li id="EN-US_TOPIC_0000001233510081__li264313529719">The tablespace of a partitioned table cannot be set to an OBS tablespace during the <strong id="EN-US_TOPIC_0000001233510081__b8547145811433">MOVE</strong>, <strong id="EN-US_TOPIC_0000001233510081__b326025744318">EXCHANGE</strong>, <strong id="EN-US_TOPIC_0000001233510081__b1269435464315">MERGE</strong>, and <strong id="EN-US_TOPIC_0000001233510081__b12802105284313">SPLIT</strong> operations.</li><li id="EN-US_TOPIC_0000001233510081__li5286158788">When an <strong id="EN-US_TOPIC_0000001233510081__b1128758587">ALTER</strong> statement is executed, the cold and hot data attributes in the partitions cannot be changed, that is, data in the cold partition should still be put in the cold partition after a data operation, and hot partition data should be put in the hot partition. Therefore, cold partition data cannot be migrated to the local tablespace.</li><li id="EN-US_TOPIC_0000001233510081__li1611213284">Only the default tablespace is supported for cold partitions.</li><li id="EN-US_TOPIC_0000001233510081__li11808040356">Cold and hot partitions cannot be merged.</li><li id="EN-US_TOPIC_0000001233510081__li197714173618">Cold partition switching is not supported for the <strong id="EN-US_TOPIC_0000001233510081__b14353182175520">EXCHANGE</strong> operation.</li></ul>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001233510081__sed5e30a3b02041749b3510272f3736aa"><h4 class="sectiontitle">Syntax</h4><ul id="EN-US_TOPIC_0000001233510081__u3bf385b1cf9546338d015b56f813b2c9"><li id="EN-US_TOPIC_0000001233510081__lfcd1b842e0204e6785c430017915f033">Modify the syntax of the table partition.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__sc671c8267c2d44209392b3a7fe1bdae6"><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="k">TABLE</span><span class="w"> </span><span class="p">[</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="p">]</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="k">table_name</span><span class="w"> </span><span class="p">[</span><span class="o">*</span><span class="p">]</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">ONLY</span><span class="w"> </span><span class="k">table_name</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">ONLY</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="k">table_name</span><span class="w"> </span><span class="p">)</span><span class="err">}</span>
<span class="w"> </span><span class="n">action</span><span class="w"> </span><span class="p">[,</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 class="p" id="EN-US_TOPIC_0000001233510081__a81a6a52f979745bbbb434709ab87c92a"><strong id="EN-US_TOPIC_0000001233510081__b4263458143612">action</strong> indicates the following clauses for maintaining partitions. For the partition continuity when multiple clauses are used for partition maintenance, <span id="EN-US_TOPIC_0000001233510081__text1932010218">GaussDB(DWS)</span> does <strong id="EN-US_TOPIC_0000001233510081__b167131040203310">DROP PARTITION</strong> and then <strong id="EN-US_TOPIC_0000001233510081__b117131440123313">ADD PARTITION</strong>, and finally runs the rest clauses in sequence.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__s9d7fbc0659c048efb2cd425fbfb08c14"><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></pre></div></td><td class="code"><div><pre><span></span><span class="w"> </span><span class="n">exchange_clause</span><span class="w"> </span><span class="o">|</span>
<span class="w"> </span><span class="n">row_clause</span><span class="w"> </span><span class="o">|</span>
<span class="w"> </span><span class="n">merge_clause</span><span class="w"> </span><span class="o">|</span>
<span class="w"> </span><span class="n">modify_clause</span><span class="w"> </span><span class="o">|</span>
<span class="w"> </span><span class="n">split_clause</span><span class="w"> </span><span class="o">|</span>
<span class="w"> </span><span class="n">add_clause</span><span class="w"> </span><span class="o">|</span>
<span class="w"> </span><span class="n">drop_clause</span>
</pre></div></td></tr></table></div>
</div>
<ul id="EN-US_TOPIC_0000001233510081__en-us_topic_0059778761_ul21778309345"><li id="EN-US_TOPIC_0000001233510081__li29552301845">The <strong id="EN-US_TOPIC_0000001233510081__b84235270615187">exchange_clause</strong> syntax is used to move the data from a general table to a specified partition.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__sf7113083a61c4a38a46d8b6610337f51"><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="n">EXCHANGE</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="n">partition_name</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">FOR</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="n">partition_value</span><span class="w"> </span><span class="p">[,</span><span class="w"> </span><span class="p">...]</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="err">}</span><span class="w"> </span>
<span class="w"> </span><span class="k">WITH</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="err">{</span><span class="p">[</span><span class="w"> </span><span class="k">ONLY</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="n">ordinary_table_name</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">ordinary_table_name</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">ONLY</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="n">ordinary_table_name</span><span class="w"> </span><span class="p">)</span><span class="err">}</span><span class="w"> </span>
<span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="k">WITH</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">WITHOUT</span><span class="w"> </span><span class="err">}</span><span class="w"> </span><span class="n">VALIDATION</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="k">VERBOSE</span><span class="w"> </span><span class="p">]</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001233510081__aefb95c36014742ff92278caf5f396f58">The ordinary table and the partitioned table whose data is to be exchanged must meet the following requirements:</p>
<ul id="EN-US_TOPIC_0000001233510081__udc8b14453eaa49ce9c2503fe3ffb5abc"><li id="EN-US_TOPIC_0000001233510081__l4d43589b386243a2b0592b129eb0816f">The number of columns of the ordinary table is the same as that of the partitioned table, and their information should be consistent, including the column name, data type, constraint, collation, storage parameter, compression, and data type of a deleted column.</li><li id="EN-US_TOPIC_0000001233510081__leab3e6863696424283189d33963c727d">The compression information of the ordinary table and partitioned table should be consistent.</li><li id="EN-US_TOPIC_0000001233510081__l1ba5a2183b4045708d4af24f9d9b4c1e">The distribution column information of the ordinary table and the partitioned table should be consistent.</li><li id="EN-US_TOPIC_0000001233510081__l588754b5761d49bcaddf747319d818fa">The number and information of indexes of the ordinary table and the partitioned table should be consistent. </li><li id="EN-US_TOPIC_0000001233510081__lad62c3f2a49d44558d274b949b93310a">The number and information of constraints of the ordinary table and the partitioned table should be consistent.</li><li id="EN-US_TOPIC_0000001233510081__l0638f3f22c164d8f9dfc13429a29275e">The ordinary table cannot be a temporary table or unlogged table.</li><li id="EN-US_TOPIC_0000001233510081__li14888134010297">The ordinary table and the partitioned table must be in the same logical cluster or node group.</li><li id="EN-US_TOPIC_0000001233510081__li443651851018">If other columns following the last valid column in the partitioned table are deleted and the deleted columns are not considered, the partitioned table can be exchanged with the ordinary table as long as the columns of the two tables are the same.</li><li id="EN-US_TOPIC_0000001233510081__li151211568485">The table-level parameter <strong id="EN-US_TOPIC_0000001233510081__b101711581228">colversion</strong> of a column-store ordinary table must be the same as that of a column-store partitioned table. Partition swap between colversion2.0 and colversion1.0 is not allowed.</li></ul>
<p id="EN-US_TOPIC_0000001233510081__p15362318105420">When the execution is complete, the data and tablespace of the ordinary table and the partitioned table are exchanged. In this case, statistics about the ordinary table and the partitioned table become unreliable. Both tables should be analyzed again.</p>
</li><li id="EN-US_TOPIC_0000001233510081__li8216173315418">The syntax of <strong id="EN-US_TOPIC_0000001233510081__en-us_topic_0058966064_b842352706152441">row_clause</strong> is used to set the row movement switch of a partitioned table.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen1321617333412"><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="err">{</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="w"> </span><span class="err">}</span><span class="w"> </span><span class="k">ROW</span><span class="w"> </span><span class="n">MOVEMENT</span>
</pre></div></td></tr></table></div>
</div>
</li></ul>
<ul id="EN-US_TOPIC_0000001233510081__u0211c66ae0e743f19ff067ad6ec5ac15"><li id="EN-US_TOPIC_0000001233510081__laf8ea077cb11462b82b794498472f1a2">The <strong id="EN-US_TOPIC_0000001233510081__b842352706151911">merge_clause</strong> syntax is used to merge partitions into one.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__sf989a48f944140bb9be8aa2f72e44576"><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="n">MERGE</span><span class="w"> </span><span class="n">PARTITIONS</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="n">partition_name</span><span class="w"> </span><span class="err">}</span><span class="w"> </span><span class="p">[,</span><span class="w"> </span><span class="p">...]</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">partition_name</span><span class="w"> </span>
</pre></div></td></tr></table></div>
</div>
<div class="notice" id="EN-US_TOPIC_0000001233510081__note9625162115211"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><ul id="EN-US_TOPIC_0000001233510081__ul36243133229"><li id="EN-US_TOPIC_0000001233510081__li1784135302819">The partition before the keyword <strong id="EN-US_TOPIC_0000001233510081__b25692402386">INTO </strong>is called the source partition, and the partition after the <strong id="EN-US_TOPIC_0000001233510081__b1910981153918">INTO </strong>is called the target partition.</li><li id="EN-US_TOPIC_0000001233510081__li13624913192219">The number of source partitions ranges from 2 to 32.</li><li id="EN-US_TOPIC_0000001233510081__li32051419112213">The source partition name must be unique.</li><li id="EN-US_TOPIC_0000001233510081__li178685024920">The source partition cannot have unusable indexes. Otherwise, an error will be reported.</li><li id="EN-US_TOPIC_0000001233510081__li17763637152417">The target partition name must either be the same as the name of the last source partition or different from all partition names of the table.</li><li id="EN-US_TOPIC_0000001233510081__li1185720242329">The boundaries of the target partition are the union of the boundaries of all the source partitions.</li><li id="EN-US_TOPIC_0000001233510081__li15708104602516">For a range partitioned table, all source partitions must have contiguous boundaries.</li><li id="EN-US_TOPIC_0000001233510081__li885112337499">For list partitioning, if the source partition contains a DEFAULT partition, the boundary of the target partition is also DEFAULT.</li></ul>
</div></div>
</li></ul>
</div>
<ul id="EN-US_TOPIC_0000001233510081__ub9996ea1350d433fb72c30d392042001"><li id="EN-US_TOPIC_0000001233510081__l9a38ba959fad4fc7bfc0b80253ace040">The syntax of <strong id="EN-US_TOPIC_0000001233510081__en-us_topic_0058966064_b842352706152352">modify_clause</strong> is used to set whether a partition index is usable.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__s6c3fe9e8412841a28948745e7393e905"><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">MODIFY</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">partition_name</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="n">UNUSABLE</span><span class="w"> </span><span class="k">LOCAL</span><span class="w"> </span><span class="n">INDEXES</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">REBUILD</span><span class="w"> </span><span class="n">UNUSABLE</span><span class="w"> </span><span class="k">LOCAL</span><span class="w"> </span><span class="n">INDEXES</span><span class="w"> </span><span class="err">}</span>
</pre></div></td></tr></table></div>
</div>
</li></ul>
<ul id="EN-US_TOPIC_0000001233510081__u3b2510c8d8694dd3a2145d47fa359c0a"><li id="EN-US_TOPIC_0000001233510081__l3d92c3540d3d4351a5af4550f9969142">The <strong id="EN-US_TOPIC_0000001233510081__b842352706151940">split_clause</strong> syntax is used to split one partition into partitions.<p id="EN-US_TOPIC_0000001233510081__p1171614112813"><strong id="EN-US_TOPIC_0000001233510081__b1396525716326">The split_clause syntax for range partitioning is as follows:</strong></p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__s9ea177ba445046e781973849f1afbec7"><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="n">SPLIT</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="n">partition_name</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">FOR</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="n">partition_value</span><span class="w"> </span><span class="p">[,</span><span class="w"> </span><span class="p">...]</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="w"> </span><span class="n">split_point_clause</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">no_split_point_clause</span><span class="w"> </span><span class="err">}</span>
</pre></div></td></tr></table></div>
</div>
<ul id="EN-US_TOPIC_0000001233510081__u837078c0fb0c4fa48e929175481072a1"><li id="EN-US_TOPIC_0000001233510081__l9734c299deea4b568c0c28673f6935c3">The syntax of <strong id="EN-US_TOPIC_0000001233510081__b24021856141018">split_point_clause</strong> is as follows:<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen11941165918810"><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">AT</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="n">partition_value</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">partition_name</span><span class="w"> </span><span class="p">,</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">partition_name</span><span class="w"> </span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
<div class="notice" id="EN-US_TOPIC_0000001233510081__n98de3ec357ba4da494d2363dc2223d40"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="EN-US_TOPIC_0000001233510081__p117418236346">The size of split point should be in the range of splitting partition key. The split point can only split one partition into two.</p>
</div></div>
</li><li id="EN-US_TOPIC_0000001233510081__ld006327d78d94a2a9e849ce27be0bed3">The syntax of <strong id="EN-US_TOPIC_0000001233510081__b842352706152243">no_split_point_clause</strong> is as follows:<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__sab512d6d35964236a8167d024b2923a2"><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">INTO</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="n">partition_less_than_item</span><span class="w"> </span><span class="p">[,</span><span class="w"> </span><span class="p">...]</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="n">partition_start_end_item</span><span class="w"> </span><span class="p">[,</span><span class="w"> </span><span class="p">...]</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="err">}</span>
</pre></div></td></tr></table></div>
</div>
<div class="notice" id="EN-US_TOPIC_0000001233510081__na831b4bf45d5496eaaf7fa949f95a81d"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><ul id="EN-US_TOPIC_0000001233510081__ul1643215449297"><li id="EN-US_TOPIC_0000001233510081__li14331444182913">The first new partition key specified by <strong id="EN-US_TOPIC_0000001233510081__b842352706152315">partition_less_than_item</strong> must be larger than that of the former partition (if any), and the last partition key specified by <strong id="EN-US_TOPIC_0000001233510081__b842352706152329">partition_less_than_item</strong> must be equal to that of the splitting partition.</li><li id="EN-US_TOPIC_0000001233510081__li1033113873014">The start point (if any) of the first new partition specified by <strong id="EN-US_TOPIC_0000001233510081__b134814743519">partition_start_end_item</strong> must be equal to the partition key (if any) of the previous partition. The end point (if any) of the last partition specified by <strong id="EN-US_TOPIC_0000001233510081__b2039723719375">partition_start_end_item</strong> must be equal to the partition key of the splitting partition.</li><li id="EN-US_TOPIC_0000001233510081__li432911121677"><strong id="EN-US_TOPIC_0000001233510081__b1752715616323">partition_less_than_item</strong> supports a maximum of four partition keys and <strong id="EN-US_TOPIC_0000001233510081__b143161612336">partition_start_end_item</strong> supports only one partition key. For details about the supported data types, see <a href="dws_06_0179.html#EN-US_TOPIC_0000001233510133__lb144da954d4c4ac58c1e9ae1391e59ac">Partition Key</a>.</li><li id="EN-US_TOPIC_0000001233510081__li189383465"><strong id="EN-US_TOPIC_0000001233510081__b1453124145314">partition_less_than_item</strong> and <strong id="EN-US_TOPIC_0000001233510081__b136734817539">partition_start_end_item</strong> cannot be used in the same statement.</li></ul>
</div></div>
</li></ul>
<ul id="EN-US_TOPIC_0000001233510081__ueeedaea9167f421cab257bdaad1a06c3"><li id="EN-US_TOPIC_0000001233510081__li1845984953910">The syntax of <strong id="EN-US_TOPIC_0000001233510081__b15784315183120">partition_less_than_item</strong> is as follows:<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen67041112194013"><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="n">PARTITION</span><span class="w"> </span><span class="n">partition_name</span><span class="w"> </span><span class="k">VALUES</span><span class="w"> </span><span class="k">LESS</span><span class="w"> </span><span class="k">THAN</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="n">partition_value</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">MAXVALUE</span><span class="w"> </span><span class="err">}</span><span class="w"> </span><span class="p">[,</span><span class="w"> </span><span class="p">...]</span><span class="w"> </span><span class="p">)</span><span class="w"> </span>
<span class="w"> </span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001233510081__lbe8a49af74cc48d0bf5cb7344d03b740">The syntax of <strong id="EN-US_TOPIC_0000001233510081__b96016418328">partition_start_end_item</strong> is as follows. For details about the constraints, see <a href="dws_06_0179.html#EN-US_TOPIC_0000001233510133__li2094151861116">partition_start_end_item syntax</a>.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__s412244d749ad4bd3989dc6ba861f1e2d"><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="n">PARTITION</span><span class="w"> </span><span class="n">partition_name</span><span class="w"> </span><span class="err">{</span>
<span class="w"> </span><span class="err">{</span><span class="k">START</span><span class="p">(</span><span class="n">partition_value</span><span class="p">)</span><span class="w"> </span><span class="k">END</span><span class="w"> </span><span class="p">(</span><span class="n">partition_value</span><span class="p">)</span><span class="w"> </span><span class="k">EVERY</span><span class="w"> </span><span class="p">(</span><span class="n">interval_value</span><span class="p">)</span><span class="err">}</span><span class="w"> </span><span class="o">|</span>
<span class="w"> </span><span class="err">{</span><span class="k">START</span><span class="p">(</span><span class="n">partition_value</span><span class="p">)</span><span class="w"> </span><span class="k">END</span><span class="w"> </span><span class="p">(</span><span class="err">{</span><span class="n">partition_value</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">MAXVALUE</span><span class="err">}</span><span class="p">)</span><span class="err">}</span><span class="w"> </span><span class="o">|</span>
<span class="w"> </span><span class="err">{</span><span class="k">START</span><span class="p">(</span><span class="n">partition_value</span><span class="p">)</span><span class="err">}</span><span class="w"> </span><span class="o">|</span>
<span class="w"> </span><span class="err">{</span><span class="k">END</span><span class="p">(</span><span class="err">{</span><span class="n">partition_value</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">MAXVALUE</span><span class="err">}</span><span class="p">)</span><span class="err">}</span>
<span class="err">}</span><span class="w"> </span>
</pre></div></td></tr></table></div>
</div>
</li></ul>
<div class="p" id="EN-US_TOPIC_0000001233510081__p1910718112417"><strong id="EN-US_TOPIC_0000001233510081__b1711711344820">The syntax of split_clause for list partitioning is as follows:</strong><div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen749040122416"><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="n">SPLIT</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="n">partition_name</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">FOR</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="n">partition_value</span><span class="w"> </span><span class="p">[,</span><span class="w"> </span><span class="p">...]</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="w"> </span><span class="n">split_values_clause</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">split_no_values_clause</span><span class="w"> </span><span class="err">}</span>
</pre></div></td></tr></table></div>
</div>
</div>
<ul id="EN-US_TOPIC_0000001233510081__ul15524144383014"><li id="EN-US_TOPIC_0000001233510081__li724018357309">The syntax of <strong id="EN-US_TOPIC_0000001233510081__b8405164219487">split_values_clause</strong> that specifies a split point is as follows:<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen12401135103013"><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">VALUES</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="p">(</span><span class="n">partition_value</span><span class="p">)</span><span class="w"> </span><span class="p">[,</span><span class="w"> </span><span class="p">...]</span><span class="w"> </span><span class="err">}</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="p">)</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">partition_name</span><span class="w"> </span><span class="p">,</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">partition_name</span><span class="w"> </span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
<div class="notice" id="EN-US_TOPIC_0000001233510081__note14240435113010"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><ul id="EN-US_TOPIC_0000001233510081__ul541015918398"><li id="EN-US_TOPIC_0000001233510081__li164105598393">If the source partition is not a <a href="dws_06_0179.html#EN-US_TOPIC_0000001233510133__li105701736194813">DEFAULT partition</a>, the boundary specified by the split point is a non-void proper subset of the source partition boundary. If the source partition is a DEFAULT partition, the boundary specified by the split point cannot overlap with the boundaries of other non-DEFAULT partitions.</li><li id="EN-US_TOPIC_0000001233510081__li118757102416">The boundary specified by the split point is the boundary of the first partition after the keyword <strong id="EN-US_TOPIC_0000001233510081__b68662214525">INTO</strong>. The difference between the boundary of the source partition and the specified boundary of the split point is the boundary of the second partition.</li><li id="EN-US_TOPIC_0000001233510081__li184111172426">If the source partition is the DEFAULT partition, the boundary of the second partition is still DEFAULT.</li></ul>
</div></div>
</li><li id="EN-US_TOPIC_0000001233510081__li870817126337">The syntax of <strong id="EN-US_TOPIC_0000001233510081__b8679118195515">split_no_values_clause</strong> that specifies no split points is as follows:<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen18650102353317"><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">INTO</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="n">list_partition_item</span><span class="w"> </span><span class="p">[,</span><span class="w"> </span><span class="p">....],</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">partition_name</span><span class="w"> </span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
<div class="notice" id="EN-US_TOPIC_0000001233510081__note1465012310339"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><ul id="EN-US_TOPIC_0000001233510081__ul3451111917323"><li id="EN-US_TOPIC_0000001233510081__li2913161231210">The syntax of <a href="dws_06_0179.html#EN-US_TOPIC_0000001233510133__li135021622911">list_partition_item</a> is the same as the syntax specifying a partition in creating a list partitioned table, except that the boundary value here cannot be DEFAULT.</li><li id="EN-US_TOPIC_0000001233510081__li945131912320">Except for the last partition, the boundaries of other partitions must be explicitly defined. The defined boundary cannot be DEFAULT and must be a non-empty proper subset of the source partition boundary. The boundary of the last partition is the difference set between the source partition boundary and other partition boundaries, and the boundary of the last partition is not empty (that is, the difference set cannot be empty).</li><li id="EN-US_TOPIC_0000001233510081__li9587037133414">If the source partition is a DEFAULT partition, the boundary of the last partition is DEFAULT.</li></ul>
</div></div>
</li></ul>
</li></ul>
<ul id="EN-US_TOPIC_0000001233510081__ucdc4b046022e49a0983ee2c6ff5233d3"><li id="EN-US_TOPIC_0000001233510081__lf2234091bb864a1b8056e5ce5dca103c">The syntax of <strong id="EN-US_TOPIC_0000001233510081__b84235270615251">add_clause</strong> is used to add a partition to one or more specified partitioned tables.<div class="p" id="EN-US_TOPIC_0000001233510081__p719152543915"><strong id="EN-US_TOPIC_0000001233510081__b1317141819116">The add_clause syntax in range partitioning is as follows:</strong><div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__s6cdfc9586fb446bcbdeba7f822a05fbc"><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">ADD</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="n">partition_less_than_item</span><span class="p">...</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">partition_start_end_item</span><span class="w"> </span><span class="err">}</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="notice" id="EN-US_TOPIC_0000001233510081__note12913154317145"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><ul id="EN-US_TOPIC_0000001233510081__ul8913114318149"><li id="EN-US_TOPIC_0000001233510081__li17419103119203">The <a href="dws_06_0179.html#EN-US_TOPIC_0000001233510133__li1147714355320">partition_less_than_item</a> syntax can only be used for range partitioned tables. Otherwise, an error will be reported.</li><li id="EN-US_TOPIC_0000001233510081__li1791394320149">The syntax of <a href="dws_06_0179.html#EN-US_TOPIC_0000001233510133__li1147714355320">partition_less_than_item</a> is the same as the syntax specifying partitions in creating a range partitioned table.</li><li id="EN-US_TOPIC_0000001233510081__li2371637181610">If the boundary value of the last partition is a MAXVALUE, new partitions cannot be added. Otherwise, an error will be reported.</li></ul>
</div></div>
<p id="EN-US_TOPIC_0000001233510081__p944617114409"><strong id="EN-US_TOPIC_0000001233510081__b1756715518194">The add_clause syntax for list partitioning is as follows:</strong></p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen8771183084014"><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">ADD</span><span class="w"> </span><span class="n">list_partition_item</span>
</pre></div></td></tr></table></div>
</div>
<div class="notice" id="EN-US_TOPIC_0000001233510081__note1939793218172"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><ul id="EN-US_TOPIC_0000001233510081__ul23971532101711"><li id="EN-US_TOPIC_0000001233510081__li258384041910">The <a href="dws_06_0179.html#EN-US_TOPIC_0000001233510133__li135021622911">list_partition_item</a> syntax can only be used for a list partitioned table. Otherwise, an error will be reported.</li><li id="EN-US_TOPIC_0000001233510081__li17398732161716">The <a href="dws_06_0179.html#EN-US_TOPIC_0000001233510133__li135021622911">list_partition_item</a> syntax is the same as the syntax specifying a partition in creating a list partitioned table.</li><li id="EN-US_TOPIC_0000001233510081__li1839816326178">If the current partition table contains DEFAULT partitions, no new partitions can be added. Otherwise, an error will be reported.</li></ul>
</div></div>
</li></ul>
<ul id="EN-US_TOPIC_0000001233510081__u6e7652b6a2004956b9422a0e2ecfeb1b"><li id="EN-US_TOPIC_0000001233510081__lfb417a730e764428a6f47e53ce206a9a">The syntax of <strong id="EN-US_TOPIC_0000001233510081__b842352706152527">drop_clause</strong> is used to remove a specified partition from a partitioned table.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__s0d0f34a4ca1b42ef9bce8114737ba4ba"><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">DROP</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="n">partition_name</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">FOR</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="n">partition_value</span><span class="w"> </span><span class="p">[,</span><span class="w"> </span><span class="p">...]</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="err">}</span><span class="w"> </span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001233510081__li193039615392">The <strong id="EN-US_TOPIC_0000001233510081__b547612101449">drop_clause</strong> syntax supports deleting multiple partitions. (supported by clusters of 8.1.3.100 and later versions)<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen1158717084012"><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">DROP</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="n">partition_name</span><span class="w"> </span><span class="p">[,</span><span class="w"> </span><span class="p">...</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="err">}</span>
</pre></div></td></tr></table></div>
</div>
</li></ul>
</li><li id="EN-US_TOPIC_0000001233510081__l4a2e453e029341ad87771b92da90f386">The syntax of modifying a table partition name is as follows:<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__s27a6afa42f514a6b9214fc7f8e591d28"><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="k">TABLE</span><span class="w"> </span><span class="p">[</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="p">]</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="k">table_name</span><span class="w"> </span><span class="p">[</span><span class="o">*</span><span class="p">]</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">ONLY</span><span class="w"> </span><span class="k">table_name</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">ONLY</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="k">table_name</span><span class="w"> </span><span class="p">)</span><span class="err">}</span>
<span class="w"> </span><span class="k">RENAME</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="n">partition_name</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">FOR</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="n">partition_value</span><span class="w"> </span><span class="p">[,</span><span class="w"> </span><span class="p">...]</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="err">}</span><span class="w"> </span><span class="k">TO</span><span class="w"> </span><span class="n">partition_new_name</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001233510081__se52593bcf84d4a8db11d3a324ea47608"><h4 class="sectiontitle">Parameter Description</h4><ul id="EN-US_TOPIC_0000001233510081__ufab25445123b49e99c5cefe104ef20b0"><li id="EN-US_TOPIC_0000001233510081__l3f18be2ee3924ea6bd6cf5ace8584547"><strong id="EN-US_TOPIC_0000001233510081__a1b83579091e54abbaa9c9efb15d9f4c9">table_name</strong><p id="EN-US_TOPIC_0000001233510081__a33e9c489888e4705b456f930d9c38e41">Specifies the name of a partitioned table.</p>
<p id="EN-US_TOPIC_0000001233510081__a5ba56aae071c477baae6e34f08d6fbcf">Value range: an existing partitioned table name</p>
</li><li id="EN-US_TOPIC_0000001233510081__lcfa9f7dca04247bc87abd9217699b1fd"><strong id="EN-US_TOPIC_0000001233510081__a2e5f536d44c347d497da3e1a3b41f060">partition_name</strong><p id="EN-US_TOPIC_0000001233510081__ae22fcea95bcf4d40987bbb56ff2387b3">Specifies the name of a partition.</p>
<p id="EN-US_TOPIC_0000001233510081__a6ff41e3c173545359e98f3ae70bf994b">Value range: an existing partition name</p>
</li><li id="EN-US_TOPIC_0000001233510081__l78e4aa924540498d855f80b6daa7c593"><strong id="EN-US_TOPIC_0000001233510081__a07bc3fe47d0e4f77b17b89522b143282">partition_value</strong><p id="EN-US_TOPIC_0000001233510081__adb44b01c7e0d44ae835b9bef1f980127">Specifies the key value of a partition.</p>
<p id="EN-US_TOPIC_0000001233510081__aed56023b94cd45e298b4b74721d04053">The value specified by <strong id="EN-US_TOPIC_0000001233510081__b84235270611514">PARTITION FOR ( partition_value [, ...] )</strong> can uniquely identify a partition.</p>
<p id="EN-US_TOPIC_0000001233510081__a8d0cd42b57ca4eda901183d6b24d14c7">Value range: value range of the partition key for the partition to be renamed</p>
</li><li id="EN-US_TOPIC_0000001233510081__la4f9a0c437a543309d7d9f12cdf6176d"><strong id="EN-US_TOPIC_0000001233510081__a183f630d56b34f74b273ed8709ef6500">UNUSABLE LOCAL INDEXES</strong><p id="EN-US_TOPIC_0000001233510081__a191c324953ae47d19a7c08eeb3b2271d">Sets all the indexes unusable in the partition.</p>
</li><li id="EN-US_TOPIC_0000001233510081__lbdd6b211ac104a24b2b44c1108473144"><strong id="EN-US_TOPIC_0000001233510081__a385f9b254ace4b0a84594a3d96860218">REBUILD UNUSABLE LOCAL INDEXES</strong><p id="EN-US_TOPIC_0000001233510081__a28d296fdba264df397edabffdc7766cb">Rebuilds all the indexes in the partition.</p>
</li><li id="EN-US_TOPIC_0000001233510081__le225efdb1c17403186d1bdcc4f46dcbe"><strong id="EN-US_TOPIC_0000001233510081__a5a54d2b446064f9690bb5393eaad1d64">ENABLE/DISABLE ROW MOVEMENT</strong><p id="EN-US_TOPIC_0000001233510081__abc2e8318ac95433fa740bd0dc87ea57b">Specifies the row movement switch.</p>
<p id="EN-US_TOPIC_0000001233510081__ae79817aeb72f40c7aecf66c395aa6731">Valid value:</p>
<ul id="EN-US_TOPIC_0000001233510081__uf84192e834d5462aa3b653388b9717c2"><li id="EN-US_TOPIC_0000001233510081__l41ac8d3fade54411bf9dc15a1c6aebe1"><strong id="EN-US_TOPIC_0000001233510081__b1344926821103347">ENABLE</strong>: The row movement switch is enabled.</li><li id="EN-US_TOPIC_0000001233510081__l8698478fb9d24a528eced23c9e05a47b"><strong id="EN-US_TOPIC_0000001233510081__b910471933103336">DISABLE</strong>: The row movement switch is disabled.</li></ul>
<p id="EN-US_TOPIC_0000001233510081__af120056a5ea749b89a69079abd89c300">The switch is disabled by default.</p>
<div class="note" id="EN-US_TOPIC_0000001233510081__note855951317366"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0000001233510081__ul562011942213"><li id="EN-US_TOPIC_0000001233510081__li116201519152217">If <strong id="EN-US_TOPIC_0000001233510081__b49034179593513">ENABLE ROW MOVEMENT</strong> is specified, cross-partition update is allowed. However, if <strong id="EN-US_TOPIC_0000001233510081__b140615602593513">SELECT FOR UPDATE</strong> is executed concurrently to query the partitioned table, the query results may be instantaneously inconsistent. Therefore, exercise caution when performing this operation.</li><li id="EN-US_TOPIC_0000001233510081__li42122212227">If the tuple value is updated on the partition key during the <strong id="EN-US_TOPIC_0000001233510081__b65775267893513">UPDATE</strong> action, the partition where the tuple is located is altered. Setting of this parameter enables error messages to be reported or movement of the tuple between partitions.</li></ul>
</div></div>
</li><li id="EN-US_TOPIC_0000001233510081__ld4cdcec74e6a48cb806dafd644d1157b"><strong id="EN-US_TOPIC_0000001233510081__aa78e093073e2400eae8f59c0a1a559ef">ordinary_table_name</strong><p id="EN-US_TOPIC_0000001233510081__ae1b2fe5dfba24cf5a5cf0250d7661868">Specifies the name of the ordinary table whose data is to be migrated.</p>
<p id="EN-US_TOPIC_0000001233510081__ab82b33d13cf54ec19d7c31289c21f52e">Value range: an existing ordinary table name</p>
</li><li id="EN-US_TOPIC_0000001233510081__lbbe21299f37f4dafbdde6c46b2791213"><strong id="EN-US_TOPIC_0000001233510081__a8151ca65c4564488ae2771ff036cf071">{ WITH | WITHOUT } VALIDATION</strong><p id="EN-US_TOPIC_0000001233510081__a7b36eb34e7e9419f919b0ed6fd2bb107">Checks whether the ordinary table data meets the specified partition key range of the partition to be migrated.</p>
<p id="EN-US_TOPIC_0000001233510081__ab19b362df8684047b04d4334153a2637">Valid value:</p>
<ul id="EN-US_TOPIC_0000001233510081__uac1e5bbe32c04803a280a1abf410a322"><li id="EN-US_TOPIC_0000001233510081__l4aecb6e4a26f4043b4ea81fc5c9f6b86"><strong id="EN-US_TOPIC_0000001233510081__b84235270695534">WITH</strong>: checks whether the common table data meets the partition key range of the partition to be exchanged. If any data does not meet the required range, an error is reported.</li><li id="EN-US_TOPIC_0000001233510081__l3f7ae0dbf412402386e2e0966bb5a204"><strong id="EN-US_TOPIC_0000001233510081__b125331119776">WITHOUT</strong>: does not check whether the common table data meets the partition key range of the partition to be exchanged.</li></ul>
<p id="EN-US_TOPIC_0000001233510081__a1ae084fa324c45d394c72eb972ee6b26">The default value is <strong id="EN-US_TOPIC_0000001233510081__b1753381917716">WITH</strong>.</p>
<p id="EN-US_TOPIC_0000001233510081__accab643e37be4504aa55ac7510cab1de">The check is time consuming, especially when the data volume is large. Therefore, use <strong id="EN-US_TOPIC_0000001233510081__b185331419270">WITHOUT</strong> when you are sure that the current common table data meets the partition key range of the partition to be exchanged.</p>
</li><li id="EN-US_TOPIC_0000001233510081__l732a66fcd91343bf851c9e6adcbd01d1"><strong id="EN-US_TOPIC_0000001233510081__a3791ff6d58814b3989e4d6c3832df67e">VERBOSE</strong><p id="EN-US_TOPIC_0000001233510081__a3ebbd1aec0d248a4962d5498a6e8f0bf">When <strong id="EN-US_TOPIC_0000001233510081__b842352706152758">VALIDATION</strong> is <strong id="EN-US_TOPIC_0000001233510081__b84235270695856">WITH</strong>, if the ordinary table contains data that is out of the partition key range, insert the data to the correct partition. If there is no correct partition where the data can be route to, an error is reported.</p>
<div class="notice" id="EN-US_TOPIC_0000001233510081__nd2a6d6ec81564f3e95cd86e1768a540e"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="EN-US_TOPIC_0000001233510081__a85588584294640c096683dbcfaa9ec0f">Only when <strong id="EN-US_TOPIC_0000001233510081__b84235270615286">VALIDATION</strong> is <strong id="EN-US_TOPIC_0000001233510081__b68202820710152">WITH</strong>, <strong id="EN-US_TOPIC_0000001233510081__b842352706152812">VERBOSE</strong> can be specified.</p>
</div></div>
</li><li id="EN-US_TOPIC_0000001233510081__lddcc8aba7b1c472cba922e783b5678c0"><strong id="EN-US_TOPIC_0000001233510081__ae78b79c9d7624784853065971e96930b">partition_new_name</strong><p id="EN-US_TOPIC_0000001233510081__a2a97cc74488b425fb3c349007f24e16a">Specifies the new name of a partition.</p>
<p id="EN-US_TOPIC_0000001233510081__a8f9df44083d9450c8d379abd3aefca19">Value range: a string. It must comply with the naming convention.</p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001233510081__section74157486248"><h4 class="sectiontitle">Examples</h4><p id="EN-US_TOPIC_0000001233510081__p356924915333">Create a range partitioned table <strong id="EN-US_TOPIC_0000001233510081__b16975953171210">customer_address</strong>.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen55110301922"><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>
<span class="normal">13</span>
<span class="normal">14</span>
<span class="normal">15</span>
<span class="normal">16</span>
<span class="normal">17</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="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>
<span class="n">PARTITION</span><span class="w"> </span><span class="k">BY</span><span class="w"> </span><span class="n">RANGE</span><span class="p">(</span><span class="n">ca_address_sk</span><span class="p">)</span>
<span class="p">(</span>
<span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">P1</span><span class="w"> </span><span class="k">VALUES</span><span class="w"> </span><span class="k">LESS</span><span class="w"> </span><span class="k">THAN</span><span class="p">(</span><span class="mi">100</span><span class="p">),</span>
<span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">P2</span><span class="w"> </span><span class="k">VALUES</span><span class="w"> </span><span class="k">LESS</span><span class="w"> </span><span class="k">THAN</span><span class="p">(</span><span class="mi">200</span><span class="p">),</span>
<span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">P3</span><span class="w"> </span><span class="k">VALUES</span><span class="w"> </span><span class="k">LESS</span><span class="w"> </span><span class="k">THAN</span><span class="p">(</span><span class="mi">300</span><span class="p">)</span>
<span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001233510081__p99741952125812">Create a list partitioned table.</p>
<pre class="screen" id="EN-US_TOPIC_0000001233510081__screen188619110591">DROP TABLE IF EXISTS data_list;
CREATE TABLE data_list(
id int,
time int,
sarlay decimal(12,2)
)PARTITION BY LIST (time)(
PARTITION P1 VALUES (202209),
PARTITION P2 VALUES (202210,202208),
PARTITION P3 VALUES (202211),
PARTITION P4 VALUES (202212),
PARTITION P5 VALUES (202301)
);</pre>
<ul id="EN-US_TOPIC_0000001233510081__ul183310242516"><li id="EN-US_TOPIC_0000001233510081__li11795525164114">The <strong id="EN-US_TOPIC_0000001233510081__b1023957641105944">modify_clause</strong> clause is used to set whether a partition index is usable.<p id="EN-US_TOPIC_0000001233510081__p15795142594118">Create the local index <strong id="EN-US_TOPIC_0000001233510081__b1260895413112617">student_grade_index</strong> for the partitioned table <strong id="EN-US_TOPIC_0000001233510081__b731352964112617">customer_address</strong> and set partition index names:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen8795142554117"><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">CREATE</span><span class="w"> </span><span class="k">INDEX</span><span class="w"> </span><span class="n">customer_address_index</span><span class="w"> </span><span class="k">ON</span><span class="w"> </span><span class="n">customer_address</span><span class="p">(</span><span class="n">ca_address_id</span><span class="p">)</span><span class="w"> </span><span class="k">LOCAL</span>
<span class="p">(</span>
<span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">P1_index</span><span class="p">,</span>
<span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">P2_index</span><span class="p">,</span>
<span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">P3_inde</span>
<span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001233510081__p2796172516414">Rebuild all indexes on partition <strong id="EN-US_TOPIC_0000001233510081__b2126136171112617">P1</strong> in the partitioned table <strong id="EN-US_TOPIC_0000001233510081__b1319585667112617">customer_address</strong>:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen18796112516415"><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="n">customer_address</span><span class="w"> </span><span class="k">MODIFY</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">P1</span><span class="w"> </span><span class="n">REBUILD</span><span class="w"> </span><span class="n">UNUSABLE</span><span class="w"> </span><span class="k">LOCAL</span><span class="w"> </span><span class="n">INDEXES</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001233510081__p157961425184118">Disable all indexes on partition <strong id="EN-US_TOPIC_0000001233510081__b1539160367112617">P3</strong> of the partitioned table <strong id="EN-US_TOPIC_0000001233510081__b562256791112617">customer_address</strong>:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen167961525154120"><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="n">customer_address</span><span class="w"> </span><span class="k">MODIFY</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">P3</span><span class="w"> </span><span class="n">UNUSABLE</span><span class="w"> </span><span class="k">LOCAL</span><span class="w"> </span><span class="n">INDEXES</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001233510081__li12833527258">The syntax of <strong id="EN-US_TOPIC_0000001233510081__b1726656926112617">add_clause</strong> is used to add a partition to one or more specified partitioned tables.<p id="EN-US_TOPIC_0000001233510081__p0316205192411">Add a partition to the range partitioned table <strong id="EN-US_TOPIC_0000001233510081__b72641105133">customer_address</strong>.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen17109102683010"><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="n">customer_address</span><span class="w"> </span><span class="k">ADD</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">P5</span><span class="w"> </span><span class="k">VALUES</span><span class="w"> </span><span class="k">LESS</span><span class="w"> </span><span class="k">THAN</span><span class="w"> </span><span class="p">(</span><span class="mi">500</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001233510081__p13169514248">Add the following partitions to the range partitioned table <strong id="EN-US_TOPIC_0000001233510081__b113181824121320">customer_address</strong>: [500, 600), [600, 700):</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen4944930103012"><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="n">customer_address</span><span class="w"> </span><span class="k">ADD</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">p6</span><span class="w"> </span><span class="k">START</span><span class="p">(</span><span class="mi">500</span><span class="p">)</span><span class="w"> </span><span class="k">END</span><span class="p">(</span><span class="mi">700</span><span class="p">)</span><span class="w"> </span><span class="k">EVERY</span><span class="p">(</span><span class="mi">100</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001233510081__p13316185118249">Add the MAXVALUE partition <strong id="EN-US_TOPIC_0000001233510081__b53119295131">p7</strong> to the range partitioned table <strong id="EN-US_TOPIC_0000001233510081__b133272913131">customer_address</strong>:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen1084583473013"><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="n">customer_address</span><span class="w"> </span><span class="k">ADD</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">p7</span><span class="w"> </span><span class="k">END</span><span class="p">(</span><span class="k">MAXVALUE</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001233510081__p173161851162411">Add partition <strong id="EN-US_TOPIC_0000001233510081__b1660317161112617">P6</strong> to the list partitioned table:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen968233816300"><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="n">data_list</span><span class="w"> </span><span class="k">ADD</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">P6</span><span class="w"> </span><span class="k">VALUES</span><span class="w"> </span><span class="p">(</span><span class="mi">202302</span><span class="p">,</span><span class="mi">202303</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
</li></ul>
<ul id="EN-US_TOPIC_0000001233510081__ul663531220258"><li id="EN-US_TOPIC_0000001233510081__li0635191212518">The <strong id="EN-US_TOPIC_0000001233510081__b118886272112617">split_clause</strong> clause is used to split one partition into partitions.<p id="EN-US_TOPIC_0000001233510081__p113174516246">Split partition <strong id="EN-US_TOPIC_0000001233510081__b999505947112617">P7</strong> in the range partitioned table <strong id="EN-US_TOPIC_0000001233510081__b1480378614112617">customer_address</strong> at <strong id="EN-US_TOPIC_0000001233510081__b160168002112617">800</strong>:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen32317167214"><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="n">customer_address</span><span class="w"> </span><span class="n">SPLIT</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">P7</span><span class="w"> </span><span class="k">AT</span><span class="p">(</span><span class="mi">800</span><span class="p">)</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="p">(</span><span class="n">PARTITION</span><span class="w"> </span><span class="n">P6a</span><span class="p">,</span><span class="n">PARTITION</span><span class="w"> </span><span class="n">P6b</span><span class="p">);</span><span class="w"> </span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001233510081__p10317251142412">Split the partition at <strong id="EN-US_TOPIC_0000001233510081__b115611315142">400</strong> in the range partitioned table <strong id="EN-US_TOPIC_0000001233510081__b338202933112617">customer_address</strong> into multiple partitions:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen020282019217"><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="n">customer_address</span><span class="w"> </span><span class="n">SPLIT</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="k">FOR</span><span class="p">(</span><span class="mi">400</span><span class="p">)</span><span class="w"> </span><span class="k">INTO</span><span class="p">(</span><span class="n">PARTITION</span><span class="w"> </span><span class="n">p_part</span><span class="w"> </span><span class="k">START</span><span class="p">(</span><span class="mi">300</span><span class="p">)</span><span class="w"> </span><span class="k">END</span><span class="p">(</span><span class="mi">500</span><span class="p">)</span><span class="w"> </span><span class="k">EVERY</span><span class="p">(</span><span class="mi">100</span><span class="p">));</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001233510081__p20317251122416">Split partition <strong id="EN-US_TOPIC_0000001233510081__b99455234164">P2</strong> in the list partitioned table <strong id="EN-US_TOPIC_0000001233510081__b3945523181613">data_list</strong> into two partitions: <strong id="EN-US_TOPIC_0000001233510081__b10945142313164">p2a</strong> and <strong id="EN-US_TOPIC_0000001233510081__b49451523201619">p2b</strong>.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen3779122332113"><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="n">data_list</span><span class="w"> </span><span class="n">SPLIT</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">P2</span><span class="w"> </span><span class="k">VALUES</span><span class="p">(</span><span class="mi">202210</span><span class="p">)</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="p">(</span><span class="n">PARTITION</span><span class="w"> </span><span class="n">p2a</span><span class="p">,</span><span class="n">PARTITION</span><span class="w"> </span><span class="n">p2b</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
</li></ul>
<ul id="EN-US_TOPIC_0000001233510081__ul31281520162619"><li id="EN-US_TOPIC_0000001233510081__li16805126152613"><strong id="EN-US_TOPIC_0000001233510081__b204373950112617">exchange_clause</strong>: migrates data from an ordinary table to a specified partition.<p id="EN-US_TOPIC_0000001233510081__p19805102610266">The following example demonstrates how to migrate data from table <strong id="EN-US_TOPIC_0000001233510081__b179511249183011">math_grade</strong> to partition <strong id="EN-US_TOPIC_0000001233510081__b075541463116">math</strong> in partition table <strong id="EN-US_TOPIC_0000001233510081__b1242122213319">student_grade</strong>. Create a partitioned <strong id="EN-US_TOPIC_0000001233510081__b20805113313319">table student_grade</strong>.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen1280510269269"><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>
<span class="normal">13</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">CREATE</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">student_grade</span><span class="w"> </span><span class="p">(</span>
<span class="w"> </span><span class="n">stu_name</span><span class="w"> </span><span class="nb">char</span><span class="p">(</span><span class="mi">5</span><span class="p">),</span>
<span class="w"> </span><span class="n">stu_no</span><span class="w"> </span><span class="nb">integer</span><span class="p">,</span>
<span class="w"> </span><span class="n">grade</span><span class="w"> </span><span class="nb">integer</span><span class="p">,</span>
<span class="w"> </span><span class="n">subject</span><span class="w"> </span><span class="nb">varchar</span><span class="p">(</span><span class="mi">30</span><span class="p">)</span>
<span class="p">)</span>
<span class="n">PARTITION</span><span class="w"> </span><span class="k">BY</span><span class="w"> </span><span class="n">LIST</span><span class="p">(</span><span class="n">subject</span><span class="p">)</span>
<span class="p">(</span>
<span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">gym</span><span class="w"> </span><span class="k">VALUES</span><span class="p">(</span><span class="s1">'gymnastics'</span><span class="p">),</span>
<span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">phys</span><span class="w"> </span><span class="k">VALUES</span><span class="p">(</span><span class="s1">'physics'</span><span class="p">),</span>
<span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">history</span><span class="w"> </span><span class="k">VALUES</span><span class="p">(</span><span class="s1">'history'</span><span class="p">),</span>
<span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">math</span><span class="w"> </span><span class="k">VALUES</span><span class="p">(</span><span class="s1">'math'</span><span class="p">)</span>
<span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001233510081__p17805726162615">Add data to the partition table <strong id="EN-US_TOPIC_0000001233510081__b393135019319">student_grade</strong>.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen18805142615267"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">INSERT</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">student_grade</span><span class="w"> </span><span class="k">VALUES</span><span class="w"> </span>
<span class="w"> </span><span class="p">(</span><span class="s1">'Ann'</span><span class="p">,</span><span class="w"> </span><span class="mi">20220101</span><span class="p">,</span><span class="w"> </span><span class="mi">75</span><span class="p">,</span><span class="w"> </span><span class="s1">'gymnastics'</span><span class="p">),</span>
<span class="w"> </span><span class="p">(</span><span class="s1">'Jeck'</span><span class="p">,</span><span class="w"> </span><span class="mi">20220103</span><span class="p">,</span><span class="w"> </span><span class="mi">60</span><span class="p">,</span><span class="w"> </span><span class="s1">'math'</span><span class="p">),</span>
<span class="w"> </span><span class="p">(</span><span class="s1">'Anna'</span><span class="p">,</span><span class="w"> </span><span class="mi">20220108</span><span class="p">,</span><span class="w"> </span><span class="mi">56</span><span class="p">,</span><span class="w"> </span><span class="s1">'history'</span><span class="p">),</span>
<span class="w"> </span><span class="p">(</span><span class="s1">'Jann'</span><span class="p">,</span><span class="w"> </span><span class="mi">20220107</span><span class="p">,</span><span class="w"> </span><span class="mi">82</span><span class="p">,</span><span class="w"> </span><span class="s1">'physics'</span><span class="p">),</span>
<span class="w"> </span><span class="p">(</span><span class="s1">'Molly'</span><span class="p">,</span><span class="w"> </span><span class="mi">20220104</span><span class="p">,</span><span class="w"> </span><span class="mi">91</span><span class="p">,</span><span class="w"> </span><span class="s1">'physics'</span><span class="p">),</span>
<span class="w"> </span><span class="p">(</span><span class="s1">'Sam'</span><span class="p">,</span><span class="w"> </span><span class="mi">20220105</span><span class="p">,</span><span class="w"> </span><span class="mi">72</span><span class="p">,</span><span class="w"> </span><span class="s1">'math'</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001233510081__p11806626172613">Query the records of partition <strong id="EN-US_TOPIC_0000001233510081__b3582221323">math </strong>in <strong id="EN-US_TOPIC_0000001233510081__b17384718133218">student_grade</strong>.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen16806162616262"><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="o">*</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">student_grade</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="p">(</span><span class="n">math</span><span class="p">);</span>
<span class="w"> </span><span class="n">stu_name</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">stu_no</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">grade</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">subject</span>
<span class="c1">----------+----------+-------+---------</span>
<span class="w"> </span><span class="n">Jeck</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">20220103</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">60</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">math</span>
<span class="w"> </span><span class="n">Sam</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">20220105</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">72</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">math</span>
<span class="p">(</span><span class="mi">2</span><span class="w"> </span><span class="k">rows</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001233510081__p1680611261261">Create an ordinary table <strong id="EN-US_TOPIC_0000001233510081__b4765152717333">math_grade</strong> that matches the definition of the partitioned table <strong id="EN-US_TOPIC_0000001233510081__b6158123853312">student_grade</strong>.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen4806426132611"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">CREATE</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">math_grade</span><span class="w"> </span>
<span class="p">(</span>
<span class="w"> </span><span class="n">stu_name</span><span class="w"> </span><span class="nb">char</span><span class="p">(</span><span class="mi">5</span><span class="p">),</span>
<span class="w"> </span><span class="n">stu_no</span><span class="w"> </span><span class="nb">integer</span><span class="p">,</span>
<span class="w"> </span><span class="n">grade</span><span class="w"> </span><span class="nb">integer</span><span class="p">,</span>
<span class="w"> </span><span class="n">subject</span><span class="w"> </span><span class="nb">varchar</span><span class="p">(</span><span class="mi">30</span><span class="p">)</span>
<span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001233510081__p88071526122614">Add data to table <strong id="EN-US_TOPIC_0000001233510081__b14445191123418">math_grade</strong>. The data is in line with the partition rule of partition <strong id="EN-US_TOPIC_0000001233510081__b128325523616">math</strong> in the partition table <strong id="EN-US_TOPIC_0000001233510081__b1413919311370">student_grade</strong>.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen68071926172610"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">INSERT</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">math_grade</span><span class="w"> </span><span class="k">VALUES</span><span class="w"> </span>
<span class="w"> </span><span class="p">(</span><span class="s1">'Ann'</span><span class="p">,</span><span class="w"> </span><span class="mi">20220101</span><span class="p">,</span><span class="w"> </span><span class="mi">75</span><span class="p">,</span><span class="w"> </span><span class="s1">'math'</span><span class="p">),</span>
<span class="w"> </span><span class="p">(</span><span class="s1">'Jeck'</span><span class="p">,</span><span class="w"> </span><span class="mi">20220103</span><span class="p">,</span><span class="w"> </span><span class="mi">60</span><span class="p">,</span><span class="w"> </span><span class="s1">'math'</span><span class="p">),</span>
<span class="w"> </span><span class="p">(</span><span class="s1">'Anna'</span><span class="p">,</span><span class="w"> </span><span class="mi">20220108</span><span class="p">,</span><span class="w"> </span><span class="mi">56</span><span class="p">,</span><span class="w"> </span><span class="s1">'math'</span><span class="p">),</span>
<span class="w"> </span><span class="p">(</span><span class="s1">'Jann'</span><span class="p">,</span><span class="w"> </span><span class="mi">20220107</span><span class="p">,</span><span class="w"> </span><span class="mi">82</span><span class="p">,</span><span class="w"> </span><span class="s1">'math'</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001233510081__p1080762613264">Migrate data from table <strong id="EN-US_TOPIC_0000001233510081__b414943413519">math_grade</strong> to partition <strong id="EN-US_TOPIC_0000001233510081__b63311729173912">math</strong> in the partition table <strong id="EN-US_TOPIC_0000001233510081__b7947123793918">student_grade</strong>.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen78071026162615"><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="n">student_grade</span><span class="w"> </span><span class="n">EXCHANGE</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="p">(</span><span class="n">math</span><span class="p">)</span><span class="w"> </span><span class="k">WITH</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">math_grade</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001233510081__p10807102692619">The query results of table <strong id="EN-US_TOPIC_0000001233510081__b534743114415">student_grade</strong> shows that the data in table <strong id="EN-US_TOPIC_0000001233510081__b156852074011">math_grade</strong> has been exchanged with the data in partition <strong id="EN-US_TOPIC_0000001233510081__b350094854013">math</strong>.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen15807126142610"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">student_grade</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="p">(</span><span class="n">math</span><span class="p">);</span>
<span class="w"> </span><span class="n">stu_name</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">stu_no</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">grade</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">subject</span>
<span class="c1">----------+----------+-------+---------</span>
<span class="w"> </span><span class="n">Anna</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">20220108</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">56</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">math</span>
<span class="w"> </span><span class="n">Jeck</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">20220103</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">60</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">math</span>
<span class="w"> </span><span class="n">Ann</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">20220101</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">75</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">math</span>
<span class="w"> </span><span class="n">Jann</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">20220107</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">82</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">math</span>
<span class="p">(</span><span class="mi">4</span><span class="w"> </span><span class="k">rows</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001233510081__p5808132619263">The query result of table <strong id="EN-US_TOPIC_0000001233510081__b4519114416411">math_grade</strong> shows that the records previously stored in partition <strong id="EN-US_TOPIC_0000001233510081__b167335420419">math</strong> have been moved to table <strong id="EN-US_TOPIC_0000001233510081__b7201191115424">student_grade</strong>.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen18808112602618"><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="o">*</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">math_grade</span><span class="p">;</span>
<span class="w"> </span><span class="n">stu_name</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">stu_no</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">grade</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">subject</span>
<span class="c1">----------+----------+-------+---------</span>
<span class="w"> </span><span class="n">Jeck</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">20220103</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">60</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">math</span>
<span class="w"> </span><span class="n">Sam</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">20220105</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">72</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">math</span>
<span class="p">(</span><span class="mi">2</span><span class="w"> </span><span class="k">rows</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</li></ul>
<ul id="EN-US_TOPIC_0000001233510081__ul15592418132512"><li id="EN-US_TOPIC_0000001233510081__li18592141811253">The <strong id="EN-US_TOPIC_0000001233510081__b1013942539112617">row_clause</strong> clause is used to set the row movement switch of a partitioned table.<p id="EN-US_TOPIC_0000001233510081__p113171512246">Enable migration for the partitioned table <strong id="EN-US_TOPIC_0000001233510081__b966870269112617">customer_address</strong>:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen7980221220"><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="n">customer_address</span><span class="w"> </span><span class="n">ENABLE</span><span class="w"> </span><span class="k">ROW</span><span class="w"> </span><span class="n">MOVEMENT</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001233510081__li19243565265">The <strong id="EN-US_TOPIC_0000001233510081__b320177325112617">merge_clause</strong> clause is used to merge partitions into one.<p id="EN-US_TOPIC_0000001233510081__p17317851102420">Combine partitions <strong id="EN-US_TOPIC_0000001233510081__b329166461112617">P2</strong> and <strong id="EN-US_TOPIC_0000001233510081__b575429223112617">P3</strong> in the range partitioned table <strong id="EN-US_TOPIC_0000001233510081__b1046277830112617">customer_address</strong> into one:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen17470179122218"><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="n">customer_address</span><span class="w"> </span><span class="n">MERGE</span><span class="w"> </span><span class="n">PARTITIONS</span><span class="w"> </span><span class="n">P2</span><span class="p">,</span><span class="w"> </span><span class="n">P3</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">P_M</span><span class="p">;</span><span class="w"> </span>
</pre></div></td></tr></table></div>
</div>
</li></ul>
<ul id="EN-US_TOPIC_0000001233510081__ul92168227259"><li id="EN-US_TOPIC_0000001233510081__li52163221258">The syntax of <strong id="EN-US_TOPIC_0000001233510081__b641315732112617">drop_clause</strong> is used to remove a specified partition from a partitioned table.<p id="EN-US_TOPIC_0000001233510081__p531775132410">Delete partition <strong id="EN-US_TOPIC_0000001233510081__b1020525852112617">P2</strong> from the partitioned table <strong id="EN-US_TOPIC_0000001233510081__b1742239151112617">customer_address</strong>:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen10926913182214"><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="n">customer_address</span><span class="w"> </span><span class="k">DROP</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">P2</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001233510081__p1531719512247">Delete partitions <strong id="EN-US_TOPIC_0000001233510081__b12301145241613">P6a</strong> and <strong id="EN-US_TOPIC_0000001233510081__b1830215211167">P6b</strong> from the partition table <strong id="EN-US_TOPIC_0000001233510081__b1230345231616">customer_address</strong>:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510081__screen13473111718221"><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="n">customer_address</span><span class="w"> </span><span class="k">DROP</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">P6a</span><span class="p">,</span><span class="w"> </span><span class="n">P6b</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001233510081__s7158bf9037ae4db2a9ec4c7903c5f5a2"><h4 class="sectiontitle">Helpful Links</h4><p id="EN-US_TOPIC_0000001233510081__a73c4d029cc6642ed946e49f9fe67dfd7"><a href="dws_06_0179.html">CREATE TABLE PARTITION</a>, <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