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

109 lines
12 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001233628579"></a><a name="EN-US_TOPIC_0000001233628579"></a>
<h1 class="topictitle1">MOVE</h1>
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0000001233628579__s4727545b57db49c3950003bb207741a5"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0000001233628579__aee8cbe98730248e198380b1b2e1821cb"><strong id="EN-US_TOPIC_0000001233628579__b14073519105537">MOVE</strong> repositions a cursor without retrieving any data. <strong id="EN-US_TOPIC_0000001233628579__en-us_topic_0058966130_b59552809105537">MOVE</strong> works exactly like the <a href="dws_06_0216.html">FETCH</a> command, except it only repositions the cursor and does not return rows.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001233628579__s27295cfa28504c348f4be3d1b7a22a33"><h4 class="sectiontitle">Precautions</h4><p id="EN-US_TOPIC_0000001233628579__a139e1f60248845e2a88e5ec35497fecc">None</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001233628579__s4feba63788ca4f0da997855f9e633249"><h4 class="sectiontitle">Syntax</h4><div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628579__s432eda0e842a42cea8721e0456926ba9"><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">MOVE</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="n">direction</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="k">cursor_name</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001233628579__a0fa07300e5514687aed0ef448038dc6e">The <strong id="EN-US_TOPIC_0000001233628579__b842352706134955">direction</strong> clause specifies optional parameters.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628579__sef9211ee5b22492a8e3b070d3264285a"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">NEXT</span>
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">PRIOR</span>
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">FIRST</span>
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">LAST</span>
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">ABSOLUTE</span><span class="w"> </span><span class="k">count</span>
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">RELATIVE</span><span class="w"> </span><span class="k">count</span>
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">count</span>
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">ALL</span>
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">FORWARD</span>
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">FORWARD</span><span class="w"> </span><span class="k">count</span>
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">FORWARD</span><span class="w"> </span><span class="k">ALL</span>
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">BACKWARD</span>
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">BACKWARD</span><span class="w"> </span><span class="k">count</span>
<span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">BACKWARD</span><span class="w"> </span><span class="k">ALL</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001233628579__s6080a89882394a029f9b39fdf99f38d3"><h4 class="sectiontitle">Parameter Description</h4><p id="EN-US_TOPIC_0000001233628579__a95e01a272bab4faf965d443bebddcf33"><strong id="EN-US_TOPIC_0000001233628579__b12721622733532">MOVE</strong> command parameters are the same as <strong id="EN-US_TOPIC_0000001233628579__b99893877533532">FETCH</strong> command parameters. For details, see <a href="dws_06_0216.html#EN-US_TOPIC_0000001233430205__s680662240a104ac7a51873c7c888bdd1">Parameter Description</a> in <strong id="EN-US_TOPIC_0000001233628579__b10988255033532">FETCH</strong>.</p>
<div class="note" id="EN-US_TOPIC_0000001233628579__nb7a4e3b107a44038beed058b0bc4b064"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001233628579__a4c56e2c594044eba876959a960883563">On successful completion, a <strong id="EN-US_TOPIC_0000001233628579__b102164062133532">MOVE</strong> command returns a command tag of the form <strong id="EN-US_TOPIC_0000001233628579__b205102266233532">MOVE count</strong>. The <strong id="EN-US_TOPIC_0000001233628579__b201039036533532">count</strong> is the number of rows that a <strong id="EN-US_TOPIC_0000001233628579__b207452890333532">FETCH</strong> command with the same parameters would have returned (possibly zero).</p>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0000001233628579__se0135a85912946dab597130a6f460588"><h4 class="sectiontitle">Examples</h4><p id="EN-US_TOPIC_0000001233628579__p15386103875318">Create table <strong id="EN-US_TOPIC_0000001233628579__b054891101414">reason</strong> and insert data into it.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628579__screen13386638175310"><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></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">reason</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">reason</span>
<span class="p">(</span>
<span class="w"> </span><span class="n">a</span><span class="w"> </span><span class="nb">int</span><span class="w"> </span><span class="k">primary</span><span class="w"> </span><span class="k">key</span><span class="p">,</span>
<span class="w"> </span><span class="n">b</span><span class="w"> </span><span class="nb">int</span><span class="p">,</span>
<span class="w"> </span><span class="k">c</span><span class="w"> </span><span class="nb">int</span>
<span class="p">);</span>
<span class="k">INSERT</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">reason</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="mi">2</span><span class="p">,</span><span class="w"> </span><span class="mi">3</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001233628579__p13902177173210">Start a transaction:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628579__screen3863034103313"><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">START</span><span class="w"> </span><span class="k">TRANSACTION</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001233628579__p19025763216">Define the <strong id="EN-US_TOPIC_0000001233628579__b9951154354216">cursor1 </strong>cursor:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628579__screen144052113335"><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">CURSOR</span><span class="w"> </span><span class="n">cursor1</span><span class="w"> </span><span class="k">FOR</span><span class="w"> </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</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001233628579__p1590297153220">Skip the first three rows of <strong id="EN-US_TOPIC_0000001233628579__b1496716533422">cursor1</strong>:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628579__screen980925153313"><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">MOVE</span><span class="w"> </span><span class="k">FORWARD</span><span class="w"> </span><span class="mi">3</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">cursor1</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001233628579__p29021977323">Fetch the first four rows from <strong id="EN-US_TOPIC_0000001233628579__b6320324134320">cursor1</strong>:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628579__screen5267658173214"><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">FETCH</span><span class="w"> </span><span class="mi">4</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">cursor1</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001233628579__p11901177113214">Close a cursor:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628579__screen1788718223315"><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">CLOSE</span><span class="w"> </span><span class="n">cursor1</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001233628579__p129014743219">End the transaction:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628579__screen1366136143311"><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">END</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001233628579__sd0b8c6216c764860b3453234cc6fab70"><h4 class="sectiontitle">Helpful Links</h4><p id="EN-US_TOPIC_0000001233628579__ade33006d444c42b385ac60c1f334fa09"><a href="dws_06_0152.html">CLOSE</a>, <a href="dws_06_0216.html">FETCH</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