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

107 lines
14 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001188588960"></a><a name="EN-US_TOPIC_0000001188588960"></a>
<h1 class="topictitle1">ALTER FOREIGN TABLE (GDS Import and Export)</h1>
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0000001188588960__s26b72b1858a44a5984f0fa6d9a84a67c"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0000001188588960__ae0128647c2ba4636aa6dfcf1ca144d9a">Modifies a foreign table.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001188588960__sa59cc6cc8a984fd197fefdd1473b4d11"><h4 class="sectiontitle">Precautions</h4><p id="EN-US_TOPIC_0000001188588960__ac7442e4e9fb44c3fbc73c718a3dc12ce">None</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001188588960__s3f9d958138244c4385543e5644eb82e6"><h4 class="sectiontitle">Syntax</h4><ul id="EN-US_TOPIC_0000001188588960__uad6e9814236f47a7b03fec657b5a42f6"><li id="EN-US_TOPIC_0000001188588960__lc8276a40978b4ae08de491947deda8d2">Set the attributes of a foreign table.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188588960__s559f66636c2b404f9d0ca71ce44b8bb8"><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">FOREIGN</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="k">table_name</span>
<span class="w"> </span><span class="k">OPTIONS</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="err">{</span><span class="p">[</span><span class="w"> </span><span class="k">ADD</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">SET</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">DROP</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="k">option</span><span class="w"> </span><span class="p">[</span><span class="s1">'value'</span><span class="p">]</span><span class="err">}</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><li id="EN-US_TOPIC_0000001188588960__lf22f8a701a9840109aac94d27bd6ce08">Set a new owner.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188588960__s226ab8de9c9b4110b4900a71f69c2026"><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">FOREIGN</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="n">tablename</span>
<span class="w"> </span><span class="k">OWNER</span><span class="w"> </span><span class="k">TO</span><span class="w"> </span><span class="n">new_owner</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001188588960__s3af932ca438d4159985b0e2e173ebf9d"><h4 class="sectiontitle">Parameter Description</h4><ul id="EN-US_TOPIC_0000001188588960__ue04df989bfb94df7b21de1f71b56727c"><li id="EN-US_TOPIC_0000001188588960__l5751924bad3741048de7fe0c54fa52c2"><strong id="EN-US_TOPIC_0000001188588960__ab68e5e9f40424175ad0b48ba2394ab66">table_name</strong><p id="EN-US_TOPIC_0000001188588960__a260f54a4ce2948f9b5c6fde471f1828a">Specifies the name of an existing foreign table to be modified.</p>
<p id="EN-US_TOPIC_0000001188588960__ace53be82edf1469496ab7847cfe92246">Value range: an existing foreign table name.</p>
</li><li id="EN-US_TOPIC_0000001188588960__l876b51e0d1f94566bc57e6ef35948c17"><strong id="EN-US_TOPIC_0000001188588960__a8c3094828b9a401ba6fa53e55526b798">option</strong><p id="EN-US_TOPIC_0000001188588960__a44b04795e5194d0aaf9cb0f6d2e777ca">Name of the option to be modified.</p>
<p id="EN-US_TOPIC_0000001188588960__a443d9ec1164f4ff4bfbc78ea86b80533">Value range: See <a href="dws_06_0159.html#EN-US_TOPIC_0000001188589008__s949bbfb7d67e4891ac3744b6ecf3bb2a">Parameter Description</a> in <strong id="EN-US_TOPIC_0000001188588960__en-us_topic_0085032468_b84235270610562">CREATE FOREIGN TABLE</strong>.</p>
</li><li id="EN-US_TOPIC_0000001188588960__l7b3eb7d573c345b795328479824cbcac"><strong id="EN-US_TOPIC_0000001188588960__aa964267e49e84048895d8a116f841b9f">value</strong><p id="EN-US_TOPIC_0000001188588960__a82cc51a116dd42d5b28c97ac3b4d3c05">Specifies the new value of <strong id="EN-US_TOPIC_0000001188588960__b84235270622312">option</strong>.</p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001188588960__sb6bdf3156b4c4f63ba96b161ff6e7d56"><h4 class="sectiontitle">Examples</h4><p id="EN-US_TOPIC_0000001188588960__p159919589267">Create a foreign table<strong id="EN-US_TOPIC_0000001188588960__b22873148267">customer_ft</strong> to import data from GDS server 10.10.123.234 in TEXT format:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188588960__screen1852553712413"><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>
<span class="normal">26</span>
<span class="normal">27</span>
<span class="normal">28</span>
<span class="normal">29</span>
<span class="normal">30</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">DROP</span><span class="w"> </span><span class="k">FOREIGN</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_ft</span><span class="p">;</span>
<span class="k">CREATE</span><span class="w"> </span><span class="k">FOREIGN</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">customer_ft</span>
<span class="p">(</span>
<span class="w"> </span><span class="n">c_customer_sk</span><span class="w"> </span><span class="nb">integer</span><span class="w"> </span><span class="p">,</span>
<span class="w"> </span><span class="n">c_customer_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="p">,</span>
<span class="w"> </span><span class="n">c_current_cdemo_sk</span><span class="w"> </span><span class="nb">integer</span><span class="w"> </span><span class="p">,</span>
<span class="w"> </span><span class="n">c_current_hdemo_sk</span><span class="w"> </span><span class="nb">integer</span><span class="w"> </span><span class="p">,</span>
<span class="w"> </span><span class="n">c_current_addr_sk</span><span class="w"> </span><span class="nb">integer</span><span class="w"> </span><span class="p">,</span>
<span class="w"> </span><span class="n">c_first_shipto_date_sk</span><span class="w"> </span><span class="nb">integer</span><span class="w"> </span><span class="p">,</span>
<span class="w"> </span><span class="n">c_first_sales_date_sk</span><span class="w"> </span><span class="nb">integer</span><span class="w"> </span><span class="p">,</span>
<span class="w"> </span><span class="n">c_salutation</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">c_first_name</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">c_last_name</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">c_preferred_cust_flag</span><span class="w"> </span><span class="nb">char</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span><span class="w"> </span><span class="p">,</span>
<span class="w"> </span><span class="n">c_birth_day</span><span class="w"> </span><span class="nb">integer</span><span class="w"> </span><span class="p">,</span>
<span class="w"> </span><span class="n">c_birth_month</span><span class="w"> </span><span class="nb">integer</span><span class="w"> </span><span class="p">,</span>
<span class="w"> </span><span class="n">c_birth_year</span><span class="w"> </span><span class="nb">integer</span><span class="w"> </span><span class="p">,</span>
<span class="w"> </span><span class="n">c_birth_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">c_login</span><span class="w"> </span><span class="nb">char</span><span class="p">(</span><span class="mi">13</span><span class="p">)</span><span class="w"> </span><span class="p">,</span>
<span class="w"> </span><span class="n">c_email_address</span><span class="w"> </span><span class="nb">char</span><span class="p">(</span><span class="mi">50</span><span class="p">)</span><span class="w"> </span><span class="p">,</span>
<span class="w"> </span><span class="n">c_last_review_date</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="p">)</span>
<span class="w"> </span><span class="n">SERVER</span><span class="w"> </span><span class="n">gsmpp_server</span>
<span class="w"> </span><span class="k">OPTIONS</span>
<span class="p">(</span>
<span class="w"> </span><span class="k">location</span><span class="w"> </span><span class="s1">'gsfs://10.10.123.234:5000/customer1*.dat'</span><span class="p">,</span>
<span class="w"> </span><span class="n">FORMAT</span><span class="w"> </span><span class="s1">'TEXT'</span><span class="w"> </span><span class="p">,</span>
<span class="w"> </span><span class="k">DELIMITER</span><span class="w"> </span><span class="s1">'|'</span><span class="p">,</span>
<span class="w"> </span><span class="k">encoding</span><span class="w"> </span><span class="s1">'utf8'</span><span class="p">,</span>
<span class="w"> </span><span class="k">mode</span><span class="w"> </span><span class="s1">'Normal'</span><span class="p">)</span><span class="k">READ</span><span class="w"> </span><span class="k">ONLY</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001188588960__p196526712341">Modify the <strong id="EN-US_TOPIC_0000001188588960__b178493798133258">customer_ft</strong> attribute of the foreign table. Delete the <strong id="EN-US_TOPIC_0000001188588960__b165231074633258">mode</strong> option.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188588960__s8dc1f9dcce8d4e8f8843c813c63b781f"><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">FOREIGN</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">customer_ft</span><span class="w"> </span><span class="k">options</span><span class="p">(</span><span class="k">drop</span><span class="w"> </span><span class="k">mode</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001188588960__s24a4b2c38f5f4153ba492bc8ba7b2192"><h4 class="sectiontitle">Helpful Links</h4><p id="EN-US_TOPIC_0000001188588960__a930cb8b630c04d0eb1a376994081155d"><a href="dws_06_0159.html">CREATE FOREIGN TABLE (for GDS Import and Export)</a>, <a href="dws_06_0192.html">DROP FOREIGN 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