forked from docs/doc-exports
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>
240 lines
37 KiB
HTML
240 lines
37 KiB
HTML
<a name="EN-US_TOPIC_0000001188270542"></a><a name="EN-US_TOPIC_0000001188270542"></a>
|
|
|
|
<h1 class="topictitle1">ALTER INDEX</h1>
|
|
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0000001188270542__s10299e85cbe847c39d0fde3a18effac6"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0000001188270542__p154343512513"><strong id="EN-US_TOPIC_0000001188270542__b842352706121050">ALTER INDEX</strong> modifies the definition of an existing index.</p>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000001188270542__s2a0d5557b2db4c8fbcaf8b6c7abdd41b"><h4 class="sectiontitle">Precautions</h4><ul id="EN-US_TOPIC_0000001188270542__ul183599575513"><li id="EN-US_TOPIC_0000001188270542__li20359185795116">Only the owner of an index or a system administrator can run this statement.</li></ul>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000001188270542__s6cad206ae9ee4e3c905b7b9d2366fac4"><h4 class="sectiontitle">Syntax</h4><ul id="EN-US_TOPIC_0000001188270542__u84c8ed4f47d24119a6cbfc79079b4ab1"><li id="EN-US_TOPIC_0000001188270542__l1363a2b271214f64b25c8c08c34ac857">Rename a table index.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188270542__s0b5b5ed914f848048100b9c605d11fea"><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">INDEX</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="n">index_name</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="k">RENAME</span><span class="w"> </span><span class="k">TO</span><span class="w"> </span><span class="n">new_name</span><span class="p">;</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
</li></ul>
|
|
<ul id="EN-US_TOPIC_0000001188270542__u051feca823704e2899df7988f72296db"><li id="EN-US_TOPIC_0000001188270542__l818148acf2884b7684d8951b6f1443a1">Modify the storage parameter of a table index.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188270542__sf403d925bece44bf9cc0da1dbfa41869"><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">INDEX</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="n">index_name</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="k">SET</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="err">{</span><span class="n">storage_parameter</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">value</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="p">);</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
</li></ul>
|
|
<ul id="EN-US_TOPIC_0000001188270542__uf607d7b4079f4020aca2bc663bc63e53"><li id="EN-US_TOPIC_0000001188270542__l7d9403c3ccfc43ed9cdcd78116c69e66">Reset the storage parameter of a table index.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188270542__s31f9576e207b4fd09cb7ec6dfbd4be72"><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">INDEX</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="n">index_name</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="k">RESET</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="n">storage_parameter</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="p">)</span><span class="w"> </span><span class="p">;</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
</li></ul>
|
|
<ul id="EN-US_TOPIC_0000001188270542__uab5d05475dd540bd9d1b20d8bcfe56da"><li id="EN-US_TOPIC_0000001188270542__l36ea39b11dfd4d5e9bd8f2592ec6c349">Set a table index or an index partition to be unavailable.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188270542__s833765699b324cbab7e1d05bd98afec0"><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">INDEX</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="n">index_name</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="p">[</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">index_partition_name</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="n">UNUSABLE</span><span class="p">;</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
<div class="note" id="EN-US_TOPIC_0000001188270542__n66d540cd81e44d20b2efe9e2d8f93532"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001188270542__a3efb19dee84b45a08125c1a5dd52102f">The syntax cannot be used for column-store tables.</p>
|
|
</div></div>
|
|
</li></ul>
|
|
<ul id="EN-US_TOPIC_0000001188270542__u084e07066e604d11a0630508419d3633"><li id="EN-US_TOPIC_0000001188270542__lcdb1bada1502446080ede00a543fe55c">Rebuild a table index or index partition.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188270542__sd11500f84ffc4b4cb0efb386ed33af7f"><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">INDEX</span><span class="w"> </span><span class="n">index_name</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="n">REBUILD</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">index_partition_name</span><span class="w"> </span><span class="p">];</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
</li></ul>
|
|
<ul id="EN-US_TOPIC_0000001188270542__uf9bd95afe2374be19235faa856239774"><li id="EN-US_TOPIC_0000001188270542__l3295d5696dd040f09ccfa7c044c0c9d0">Rename an index partition.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188270542__sacea3a0ca5a94f40b0036c83eb8288d8"><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">INDEX</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="n">index_name</span><span class="w"> </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="n">index_partition_name</span><span class="w"> </span><span class="k">TO</span><span class="w"> </span><span class="n">new_index_partition_name</span><span class="p">;</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
<div class="note" id="EN-US_TOPIC_0000001188270542__note1634710268499"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001188270542__p6347122618497"><strong id="EN-US_TOPIC_0000001188270542__b14490331376">PG_OBJECT</strong> does not support the record of the syntax when the last modification time of the index is recorded.</p>
|
|
</div></div>
|
|
</li></ul>
|
|
</div>
|
|
<ul id="EN-US_TOPIC_0000001188270542__ul20539141911514"><li id="EN-US_TOPIC_0000001188270542__li135391192158">Add and modify the index comment.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188270542__screen531847141616"><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">INDEX</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="n">index_name</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="k">COMMENT</span><span class="w"> </span><span class="s1">'text'</span><span class="p">;</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
</li><li id="EN-US_TOPIC_0000001188270542__li327517445818">Delete the index comment.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188270542__screen812456151113"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">ALTER</span><span class="w"> </span><span class="k">INDEX</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="n">index_name</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="k">COMMENT</span><span class="w"> </span><span class="s1">''</span><span class="p">;</span>
|
|
<span class="k">ALTER</span><span class="w"> </span><span class="k">INDEX</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="n">index_name</span>
|
|
<span class="w"> </span><span class="k">COMMENT</span><span class="w"> </span><span class="k">NULL</span><span class="p">;</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
</li></ul>
|
|
<div class="section" id="EN-US_TOPIC_0000001188270542__s52de0c19fcc349629b947d9dfad0c1ea"><h4 class="sectiontitle">Parameter Description</h4><ul id="EN-US_TOPIC_0000001188270542__ul13475143110142"><li id="EN-US_TOPIC_0000001188270542__li94752314144"><strong id="EN-US_TOPIC_0000001188270542__b426911196913">IF EXISTS</strong><p id="EN-US_TOPIC_0000001188270542__p4475831141412">If the specified index does not exist, a notice instead of an error is sent.</p>
|
|
</li><li id="EN-US_TOPIC_0000001188270542__li18475123131414"><strong id="EN-US_TOPIC_0000001188270542__b1530822211910">RENAME TO</strong><p id="EN-US_TOPIC_0000001188270542__p54751131161415">Changes only the name of the index. There is no effect on the stored data. </p>
|
|
</li><li id="EN-US_TOPIC_0000001188270542__li1247617311144"><strong id="EN-US_TOPIC_0000001188270542__b1559113113910">SET ( { STORAGE_PARAMETER = value } [, ...] )</strong><p id="EN-US_TOPIC_0000001188270542__p1747615310149">Change one or more index-method-specific storage parameters. Note that the index contents will not be modified immediately by this command. You might need to rebuild the index with <strong id="EN-US_TOPIC_0000001188270542__b84235270693543">REINDEX</strong> to get the desired effects depending on parameters.</p>
|
|
</li><li id="EN-US_TOPIC_0000001188270542__li4476193111411"><strong id="EN-US_TOPIC_0000001188270542__b16547634591">RESET ( { storage_parameter } [, ...] )</strong><p id="EN-US_TOPIC_0000001188270542__p11476831121417">Reset one or more index-method-specific storage parameters to the default value. Similar to the <strong id="EN-US_TOPIC_0000001188270542__en-us_topic_0058966167_b842352706214040">SET</strong> statement, <strong id="EN-US_TOPIC_0000001188270542__en-us_topic_0058966167_b842352706214053">REINDEX</strong> may be used to completely update the index.</p>
|
|
</li><li id="EN-US_TOPIC_0000001188270542__li184761531191416"><strong id="EN-US_TOPIC_0000001188270542__b899114391498">[ MODIFY PARTITION index_partition_name ] UNUSABLE</strong><p id="EN-US_TOPIC_0000001188270542__p1047619311142">Sets the index on a table or index partition to be unavailable.</p>
|
|
</li><li id="EN-US_TOPIC_0000001188270542__li647623115145"><strong id="EN-US_TOPIC_0000001188270542__b16494185719917">REBUILD [ PARTITION index_partition_name ]</strong><p id="EN-US_TOPIC_0000001188270542__p134763310148">Recreates the index on a table or index partition.</p>
|
|
</li><li id="EN-US_TOPIC_0000001188270542__li13476133112142"><strong id="EN-US_TOPIC_0000001188270542__b164610548913">RENAME PARTITION</strong><p id="EN-US_TOPIC_0000001188270542__p19476931171414">Renames an index partition.</p>
|
|
</li><li id="EN-US_TOPIC_0000001188270542__li20476123119143"><strong id="EN-US_TOPIC_0000001188270542__b1025813481699">COMMENT comment_text</strong><p id="EN-US_TOPIC_0000001188270542__p1847773115149">Adds, modifies, or deletes index comments.</p>
|
|
</li></ul>
|
|
<ul id="EN-US_TOPIC_0000001188270542__ueec0d2180da64393b504b0492497408b"><li id="EN-US_TOPIC_0000001188270542__lb5a581cea2e9489b901d83488ea5ac83"><strong id="EN-US_TOPIC_0000001188270542__a321a7220147b4ce299c548770d8072b6">index_name</strong><p id="EN-US_TOPIC_0000001188270542__a0d9ae1ad4d0c421daca43bcf5c26c1e6">Specifies the index name to be modified.</p>
|
|
</li><li id="EN-US_TOPIC_0000001188270542__l80ccbdfa6cdd4958b588e31417249ddf"><strong id="EN-US_TOPIC_0000001188270542__a81420552f83542e784f97a6c10cebfa0">new_name</strong><p id="EN-US_TOPIC_0000001188270542__a58ae172da8b94eefbacc6145d6277724">Specifies the new name for the index. The new index name cannot be the same as an existing table name in the database.</p>
|
|
<p id="EN-US_TOPIC_0000001188270542__aa3fd9f78e23d47f9875b02b9450b9ebb">Value range: a string that must comply with the identifier naming rules.</p>
|
|
</li><li id="EN-US_TOPIC_0000001188270542__lf39f468f02874ab1bfb87a809ad1eb4a"><strong id="EN-US_TOPIC_0000001188270542__a83f6000ed1964f65b3c055f1308fa79a">storage_parameter</strong><p id="EN-US_TOPIC_0000001188270542__a79b7e4eaed3f472294a59fda2a664e6a">Specifies the name of an index-method-specific parameter.</p>
|
|
</li><li id="EN-US_TOPIC_0000001188270542__lfadf25dffdfb49bea40baf43cfa9e23e"><strong id="EN-US_TOPIC_0000001188270542__a9e4717661b8e4fda82d9f625f0a9d8bb">value</strong><p id="EN-US_TOPIC_0000001188270542__a0398495b37474528b65bf8aa00d50a2e">Specifies the new value for an index-method-specific storage parameter. This might be a number or a word depending on the parameter. </p>
|
|
</li><li id="EN-US_TOPIC_0000001188270542__l02c2c34e3a2c426880176247c7aa8242"><strong id="EN-US_TOPIC_0000001188270542__adb41cc3e6dbd4047a8457876807bab20">new_index_partition_name</strong><p id="EN-US_TOPIC_0000001188270542__af8a53d9694db46f79747f19153a17693">Specifies the new name of the index partition.</p>
|
|
</li><li id="EN-US_TOPIC_0000001188270542__l4307a4aa36e74b5c82729a8584baca28"><strong id="EN-US_TOPIC_0000001188270542__a9f26ad23a6ea4abda78aca8e2a82df4b">index_partition_name</strong><p id="EN-US_TOPIC_0000001188270542__af322fb5c6e78473a99b5561f7bf1dcfb">Specifies the name of the index partition.</p>
|
|
</li><li id="EN-US_TOPIC_0000001188270542__li1886819111711"><strong id="EN-US_TOPIC_0000001188270542__b116425122711">comment_text</strong><p id="EN-US_TOPIC_0000001188270542__p2651714181712">Comment of an index.</p>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000001188270542__sf3bd0e6fc9b746e3a1a6a7e6fbd53f24"><h4 class="sectiontitle">Example</h4><ul id="EN-US_TOPIC_0000001188270542__ul15192121344310"><li id="EN-US_TOPIC_0000001188270542__li12061634422">Modifying Table Index<div class="p" id="EN-US_TOPIC_0000001188270542__p976336164220"><a name="EN-US_TOPIC_0000001188270542__li12061634422"></a><a name="li12061634422"></a>Create a sample table named <strong id="EN-US_TOPIC_0000001188270542__b7729033299309"><span id="EN-US_TOPIC_0000001188270542__text8847134019309">tpcds.</span>ship_mode_t1</strong>.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188270542__screen8785122414522"><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></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">tpcds</span><span class="p">.</span><span class="n">ship_mode_t1</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">tpcds</span><span class="p">.</span><span class="n">ship_mode_t1</span>
|
|
<span class="p">(</span>
|
|
<span class="w"> </span><span class="n">SM_SHIP_MODE_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="p">,</span>
|
|
<span class="w"> </span><span class="n">SM_SHIP_MODE_ID</span><span class="w"> </span><span class="nb">CHAR</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="p">,</span>
|
|
<span class="w"> </span><span class="n">SM_TYPE</span><span class="w"> </span><span class="nb">CHAR</span><span class="p">(</span><span class="mi">30</span><span class="p">)</span><span class="w"> </span><span class="p">,</span>
|
|
<span class="w"> </span><span class="n">SM_CODE</span><span class="w"> </span><span class="nb">CHAR</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">SM_CARRIER</span><span class="w"> </span><span class="nb">CHAR</span><span class="p">(</span><span class="mi">20</span><span class="p">)</span><span class="w"> </span><span class="p">,</span>
|
|
<span class="w"> </span><span class="n">SM_CONTRACT</span><span class="w"> </span><span class="nb">CHAR</span><span class="p">(</span><span class="mi">20</span><span class="p">)</span>
|
|
<span class="p">)</span><span class="w"> </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="p">(</span><span class="n">SM_SHIP_MODE_SK</span><span class="p">);</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
</div>
|
|
<p id="EN-US_TOPIC_0000001188270542__p134501054135118">Create a unique index on the <strong id="EN-US_TOPIC_0000001188270542__b11095948299309">SM_SHIP_MODE_SK</strong> column in the <strong id="EN-US_TOPIC_0000001188270542__b19505385379309"><span id="EN-US_TOPIC_0000001188270542__text11437112869309">tpcds.</span>ship_mode_t1</strong> table.</p>
|
|
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188270542__screen14758318537"><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">DROP</span><span class="w"> </span><span class="k">INDEX</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">ds_ship_mode_t1_index1</span><span class="p">;</span>
|
|
<span class="k">CREATE</span><span class="w"> </span><span class="k">UNIQUE</span><span class="w"> </span><span class="k">INDEX</span><span class="w"> </span><span class="n">ds_ship_mode_t1_index1</span><span class="w"> </span><span class="k">ON</span><span class="w"> </span><span class="n">tpcds</span><span class="p">.</span><span class="n">ship_mode_t1</span><span class="p">(</span><span class="n">SM_SHIP_MODE_SK</span><span class="p">);</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
<p id="EN-US_TOPIC_0000001188270542__p344825418513">Create an expression index on the <strong id="EN-US_TOPIC_0000001188270542__b3523116579309">SM_CODE</strong> column in the <strong id="EN-US_TOPIC_0000001188270542__b7040176269309"><span id="EN-US_TOPIC_0000001188270542__text482300079309">tpcds.</span>ship_mode_t1</strong> table.</p>
|
|
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188270542__screen13806171716572"><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">DROP</span><span class="w"> </span><span class="k">INDEX</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">ds_ship_mode_t1_index2</span><span class="p">;</span>
|
|
<span class="k">CREATE</span><span class="w"> </span><span class="k">INDEX</span><span class="w"> </span><span class="n">ds_ship_mode_t1_index2</span><span class="w"> </span><span class="k">ON</span><span class="w"> </span><span class="n">tpcds</span><span class="p">.</span><span class="n">ship_mode_t1</span><span class="p">(</span><span class="n">SUBSTR</span><span class="p">(</span><span class="n">SM_CODE</span><span class="p">,</span><span class="mi">1</span><span class="w"> </span><span class="p">,</span><span class="mi">4</span><span class="p">));</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
<p id="EN-US_TOPIC_0000001188270542__p1068716598379">Rename the <strong id="EN-US_TOPIC_0000001188270542__b1383132811615">ds_ship_mode_t1_index1</strong> index to <strong id="EN-US_TOPIC_0000001188270542__b4833287620">ds_ship_mode_t1_index5</strong>:</p>
|
|
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188270542__screen1878795012510"><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">INDEX</span><span class="w"> </span><span class="n">tpcds</span><span class="p">.</span><span class="n">ds_ship_mode_t1_index1</span><span class="w"> </span><span class="k">RENAME</span><span class="w"> </span><span class="k">TO</span><span class="w"> </span><span class="n">ds_ship_mode_t1_index5</span><span class="p">;</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
<p id="EN-US_TOPIC_0000001188270542__p1377413333818">Set the <strong id="EN-US_TOPIC_0000001188270542__b152951633562">ds_ship_mode_t1_index2</strong> index as unusable:</p>
|
|
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188270542__screen1296012117521"><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">INDEX</span><span class="w"> </span><span class="n">tpcds</span><span class="p">.</span><span class="n">ds_ship_mode_t1_index2</span><span class="w"> </span><span class="n">UNUSABLE</span><span class="p">;</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
<p id="EN-US_TOPIC_0000001188270542__p1045810103815">Rebuild the <strong id="EN-US_TOPIC_0000001188270542__b106131746562">ds_ship_mode_t1_index2</strong> index:</p>
|
|
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188270542__screen126603005210"><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">INDEX</span><span class="w"> </span><span class="n">tpcds</span><span class="p">.</span><span class="n">ds_ship_mode_t1_index2</span><span class="w"> </span><span class="n">REBUILD</span><span class="p">;</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
</li></ul>
|
|
<ul id="EN-US_TOPIC_0000001188270542__ul19941448104310"><li id="EN-US_TOPIC_0000001188270542__li81112414427">Modifying Partition Index<div class="p" id="EN-US_TOPIC_0000001188270542__p1045402610422"><a name="EN-US_TOPIC_0000001188270542__li81112414427"></a><a name="li81112414427"></a>Create a sample table named <strong id="EN-US_TOPIC_0000001188270542__b12599607819309"><span id="EN-US_TOPIC_0000001188270542__text4695724709309">tpcds.</span>customer_address_p1</strong>.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188270542__screen3956161283613"><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>
|
|
<span class="normal">18</span>
|
|
<span class="normal">19</span>
|
|
<span class="normal">20</span>
|
|
<span class="normal">21</span>
|
|
<span class="normal">22</span>
|
|
<span class="normal">23</span>
|
|
<span class="normal">24</span>
|
|
<span class="normal">25</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">tpcds</span><span class="p">.</span><span class="n">customer_address_p1</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">tpcds</span><span class="p">.</span><span class="n">customer_address_p1</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="p">,</span>
|
|
<span class="w"> </span><span class="n">CA_ADDRESS_ID</span><span class="w"> </span><span class="nb">CHAR</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="p">,</span>
|
|
<span class="w"> </span><span class="n">CA_STREET_NUMBER</span><span class="w"> </span><span class="nb">CHAR</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">VARCHAR</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">CHAR</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">CHAR</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_CITY</span><span class="w"> </span><span class="nb">VARCHAR</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_COUNTY</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="w"> </span><span class="p">,</span>
|
|
<span class="w"> </span><span class="n">CA_STATE</span><span class="w"> </span><span class="nb">CHAR</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span><span class="w"> </span><span class="p">,</span>
|
|
<span class="w"> </span><span class="n">CA_ZIP</span><span class="w"> </span><span class="nb">CHAR</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_COUNTRY</span><span class="w"> </span><span class="nb">VARCHAR</span><span class="p">(</span><span class="mi">20</span><span class="p">)</span><span class="w"> </span><span class="p">,</span>
|
|
<span class="w"> </span><span class="n">CA_GMT_OFFSET</span><span class="w"> </span><span class="nb">DECIMAL</span><span class="p">(</span><span class="mi">5</span><span class="p">,</span><span class="mi">2</span><span class="p">)</span><span class="w"> </span><span class="p">,</span>
|
|
<span class="w"> </span><span class="n">CA_LOCATION_TYPE</span><span class="w"> </span><span class="nb">CHAR</span><span class="p">(</span><span class="mi">20</span><span class="p">)</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="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="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="w"> </span><span class="p">(</span><span class="mi">3000</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="w"> </span><span class="p">(</span><span class="mi">5000</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">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="w"> </span><span class="p">(</span><span class="k">MAXVALUE</span><span class="p">)</span><span class="w"> </span>
|
|
<span class="p">)</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>
|
|
</div>
|
|
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188270542__screen159585438366"></div>
|
|
<p id="EN-US_TOPIC_0000001188270542__p168800535345">Create the partitioned table index <strong id="EN-US_TOPIC_0000001188270542__b1481147189309">ds_customer_address_p1_index2</strong> with the name of the index partition specified.</p>
|
|
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188270542__screen2321171315379"><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">DROP</span><span class="w"> </span><span class="k">INDEX</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">ds_customer_address_p1_index2</span><span class="p">;</span>
|
|
<span class="k">CREATE</span><span class="w"> </span><span class="k">INDEX</span><span class="w"> </span><span class="n">ds_customer_address_p1_index2</span><span class="w"> </span><span class="k">ON</span><span class="w"> </span><span class="n">tpcds</span><span class="p">.</span><span class="n">customer_address_p1</span><span class="p">(</span><span class="n">CA_ADDRESS_SK</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">CA_ADDRESS_SK_index1</span><span class="p">,</span>
|
|
<span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">CA_ADDRESS_SK_index2</span><span class="p">,</span>
|
|
<span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="n">CA_ADDRESS_SK_index3</span><span class="w"> </span>
|
|
<span class="p">)</span><span class="w"> </span>
|
|
<span class="p">;</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
<p id="EN-US_TOPIC_0000001188270542__p1251251706">Rename the partition index <span id="EN-US_TOPIC_0000001188270542__text868763831217">tpcds.</span> as <strong id="EN-US_TOPIC_0000001188270542__b10198134918114">ds_customer_address_p1_index2</strong>.</p>
|
|
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188270542__screen35241126883"><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">INDEX</span><span class="w"> </span><span class="n">tpcds</span><span class="p">.</span><span class="n">ds_customer_address_p1_index2</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="n">CA_ADDRESS_SK_index1</span><span class="w"> </span><span class="k">TO</span><span class="w"> </span><span class="n">CA_ADDRESS_SK_index4</span><span class="p">;</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
<p id="EN-US_TOPIC_0000001188270542__p119250318219">Modify the index comment:</p>
|
|
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188270542__screen18178184201812"><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">INDEX</span><span class="w"> </span><span class="n">tpcds</span><span class="p">.</span><span class="n">ds_customer_address_p1_index2</span><span class="w"> </span><span class="k">COMMENT</span><span class="w"> </span><span class="s1">'comment_ds_customer_address_p1_index2'</span><span class="p">;</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000001188270542__s63875c5c56534d2db6418ba5e306a898"><h4 class="sectiontitle">Links</h4><p id="EN-US_TOPIC_0000001188270542__a9f1920e5363d4187b2f67edfcc608a8d"><a href="dws_06_0165.html">CREATE INDEX</a>, <a href="dws_06_0195.html">DROP INDEX</a>, <a href="dws_06_0218.html">REINDEX</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>
|
|
|