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

73 lines
13 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001856158621"></a><a name="EN-US_TOPIC_0000001856158621"></a>
<h1 class="topictitle1">INSERT</h1>
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_s913a34a64c084a138d56f7fbfe5916cc"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_ac9038235a6954dcb9e97e86fe5d26667">Insert one or more rows of data into an HStore table.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_sca82b0b9d8d8442ca9d8447acb2edf50"><h4 class="sectiontitle">Precautions</h4><ul id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_udb2d07d9ae2541d4a7105616a77404f3"><li id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_li17844145891112">If the data to be inserted at a time is greater than or equal to the value of the table-level parameter <strong id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_b17649152183614">DELTAROW_THRESHOLD</strong>, the data is directly inserted into the primary table to generate a compression unit (CU).</li><li id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_li11425111713505">If the data to be inserted is smaller than <strong id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_b1750819234817">DELTAROW_THRESHOLD</strong>, a record of the type <strong id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_b2085923215488">I</strong> will be inserted into the delta table. The data will be serialized and stored in the <strong id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_b1331055174819">values</strong> field of the record.</li><li id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_li181691496129">CUIDs are allocated to the data in the delta table and the primary table in a unified manner.</li><li id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_li191671211111318">The data inserted into the delta table depends on AUTOVACUUM to merge to primary table CUs.</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_se26969fe97994814b5f45a6173164204"><h4 class="sectiontitle">Syntax</h4><div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_s51f2f81628824457b9a60a64a85eed91"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">INSERT</span><span class="w"> </span><span class="p">[</span><span class="cm">/*+ plan_hint */</span><span class="p">]</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="k">IGNORE</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">OVERWRITE</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="k">table_name</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">alias</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="k">column_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="p">]</span>
<span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="k">DEFAULT</span><span class="w"> </span><span class="k">VALUES</span>
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">VALUES</span><span class="w"> </span><span class="err">{</span><span class="p">(</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="n">expression</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="p">...]</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="p">...]</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">query</span><span class="w"> </span><span class="err">}</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_s607f0d6336b9473ea352e2b4338007fd"><h4 class="sectiontitle">Parameters</h4><ul id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_uf3d37e5bb5214918964a03fd40a4679d"><li id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_l2e7c51aac0a94a18bf457a6cb51fc92b"><strong id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_aef279db8808241e987b7b541d8d7fdba">table_name</strong><p id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_afd87c3971a4d4428b1326a6b1633bd60">Specifies the name of the target table.</p>
<p id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_a401d03c284e5426eba3276a1cd43d465">Value range: an existing table name</p>
</li><li id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_li1955818209371"><strong id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_b125421424103719">AS</strong><p id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_p331372793710">Specifies an alias for the target table <em id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_i12113106132316">table_name</em>. <em id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_i38427417232">alias</em> indicates the alias name.</p>
</li><li id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_l0e820def95a8474aaab80ee445063ba5"><strong id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_aa0f0ac51fd9b4f9ba477113c04d4b936">column_name</strong><p id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_a87b77c72ccf44651a0e0a66508a7ae79">Specifies the name of a column in a table.</p>
</li><li id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_l5ed6b86e332a418380c47e8aa004d6ec"><strong id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_a219545b6fd734546b36c86c6339faeb1">query</strong><p id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_afc1d45e221074bf68414f4454f382868">Specifies a query statement (<strong id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_b12225124022516">SELECT</strong> statement) that uses the query result as the inserted data.</p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_s34f59f03fabd44b7b12042e7cd73f6be"><h4 class="sectiontitle">Example</h4><div class="p" id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_p521318772119">Create the <strong id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_b1830851022611">reason_t1</strong> table.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_screen11878445154415"><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="c1">-- Create the reason_t1 table.</span>
<span class="k">CREATE</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">reason_t1</span>
<span class="p">(</span>
<span class="w"> </span><span class="n">TABLE_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">TABLE_ID</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">TABLE_NA</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="p">)</span><span class="k">WITH</span><span class="p">(</span><span class="n">ORIENTATION</span><span class="o">=</span><span class="k">COLUMN</span><span class="p">,</span><span class="w"> </span><span class="n">ENABLE_HSTORE</span><span class="o">=</span><span class="k">ON</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="p" id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_p182389602214">Insert a record into a table.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_screen32380618226"><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">INSERT</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">reason_t1</span><span class="p">(</span><span class="n">TABLE_SK</span><span class="p">,</span><span class="w"> </span><span class="n">TABLE_ID</span><span class="p">,</span><span class="w"> </span><span class="n">TABLE_NA</span><span class="p">)</span><span class="w"> </span><span class="k">VALUES</span><span class="w"> </span><span class="p">(</span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="s1">'S01'</span><span class="p">,</span><span class="w"> </span><span class="s1">'StudentA'</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="p" id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_p17303181642212">Insert records into the table.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001856158621__en-us_topic_0000001442278204_screen1930481622215"><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">INSERT</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">reason_t1</span><span class="w"> </span><span class="k">VALUES</span><span class="w"> </span><span class="p">(</span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="s1">'S01'</span><span class="p">,</span><span class="w"> </span><span class="s1">'StudentA'</span><span class="p">),(</span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="s1">'T01'</span><span class="p">,</span><span class="w"> </span><span class="s1">'TeacherA'</span><span class="p">),(</span><span class="mi">3</span><span class="p">,</span><span class="w"> </span><span class="s1">'T02'</span><span class="p">,</span><span class="w"> </span><span class="s1">'TeacherB'</span><span class="p">);</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">reason_t1</span><span class="w"> </span><span class="k">ORDER</span><span class="w"> </span><span class="k">BY</span><span class="w"> </span><span class="mi">1</span><span class="p">;</span>
<span class="w"> </span><span class="n">TABLE_SK</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">TABLE_ID</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">TABLE_NAME</span>
<span class="c1">----------+----------+------------</span>
<span class="w"> </span><span class="mi">1</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">S01</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">StudentA</span>
<span class="w"> </span><span class="mi">2</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">T01</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">TeacherA</span>
<span class="w"> </span><span class="mi">3</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">T02</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">TeacherB</span>
<span class="p">(</span><span class="mi">3</span><span class="w"> </span><span class="k">rows</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_04_1026.html">Hybrid Data Warehouse Syntax</a></div>
</div>
</div>
View Git Blame Copy Permalink