vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/dws/tool/dws_gsql_003.html
Lu, Huayi 346ac31da9 DWS TG 8.1.3.200 VERSION 
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Reviewed-by: Jiang, Beibei <beibei.jiang@t-systems.com>
Co-authored-by: Lu, Huayi <luhuayi@huawei.com>
Co-committed-by: Lu, Huayi <luhuayi@huawei.com>
2023-08-28 09:20:17 +00:00

176 lines
21 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001188521082"></a><a name="EN-US_TOPIC_0000001188521082"></a>
<h1 class="topictitle1">Instruction</h1>
<div id="body0000001107210702"><div class="section" id="EN-US_TOPIC_0000001188521082__en-us_topic_0000001188680968_section16651183742718"><h4 class="sectiontitle">Downloading and Installing gsql and Using It to Connect to the Cluster Database</h4><p id="EN-US_TOPIC_0000001188521082__en-us_topic_0000001188680968_p167428165597">For details about how to download and install gsql and connect it to the cluster database, see section "Using the gsql CLI Client to Connect to a Cluster" in the <em id="EN-US_TOPIC_0000001188521082__en-us_topic_0000001188680968_i176831408414">Data Warehouse Service (DWS) User Guide</em>.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001188521082__en-us_topic_0000001188680968_en-us_topic_0000001098970314_sef1e62c5769546a8a55f394e7ea7d002"><h4 class="sectiontitle">Example</h4><p id="EN-US_TOPIC_0000001188521082__en-us_topic_0000001188680968_en-us_topic_0000001098970314_a2f07a362101e4132a72382af88b40320">The example shows how to spread a command over several lines of input. Pay attention to prompt changes:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188521082__en-us_topic_0000001188680968_en-us_topic_0000001098970314_s8d6fbc76e89843fcb5efec75ca2d5ed0"><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="n">postgres</span><span class="o">=#</span><span class="w"> </span><span class="k">CREATE</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">HR</span><span class="p">.</span><span class="n">areaS</span><span class="p">(</span>
<span class="n">postgres</span><span class="p">(</span><span class="o">#</span><span class="w"> </span><span class="n">area_ID</span><span class="w"> </span><span class="nb">NUMBER</span><span class="p">,</span>
<span class="n">postgres</span><span class="p">(</span><span class="o">#</span><span class="w"> </span><span class="n">area_NAME</span><span class="w"> </span><span class="n">VARCHAR2</span><span class="p">(</span><span class="mi">25</span><span class="p">)</span>
<span class="n">postgres</span><span class="o">-#</span><span class="w"> </span><span class="p">)</span><span class="n">tablespace</span><span class="w"> </span><span class="n">EXAMPLE</span><span class="p">;</span>
<span class="k">CREATE</span><span class="w"> </span><span class="k">TABLE</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001188521082__en-us_topic_0000001188680968_en-us_topic_0000001098970314_a86a74d28463141799dedf68ea2836e52">View the table definition.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188521082__en-us_topic_0000001188680968_en-us_topic_0000001098970314_s312175c870b74e93a0c2a934633be996"><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="err">\</span><span class="n">d</span><span class="w"> </span><span class="n">HR</span><span class="p">.</span><span class="n">areaS</span>
<span class="w"> </span><span class="k">Table</span><span class="w"> </span><span class="ss">&quot;hr.areas&quot;</span>
<span class="w"> </span><span class="k">Column</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">Type</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">Modifiers</span><span class="w"> </span>
<span class="c1">-----------+-----------------------+-----------</span>
<span class="w"> </span><span class="n">area_id</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="nb">numeric</span><span class="w"> </span><span class="o">|</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="n">area_name</span><span class="w"> </span><span class="o">|</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">25</span><span class="p">)</span><span class="w"> </span><span class="o">|</span><span class="w"> </span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001188521082__en-us_topic_0000001188680968_en-us_topic_0000001098970314_a22c6e74569ae4521b3a46385173566fb">Insert four lines of data into <strong id="EN-US_TOPIC_0000001188521082__en-us_topic_0000001188680968_en-us_topic_0000001098970314_b16328122581910">HR.areaS</strong>.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188521082__en-us_topic_0000001188680968_en-us_topic_0000001098970314_s1f08d819947f46f689712dddc1d7ea89"><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">HR</span><span class="p">.</span><span class="n">areaS</span><span class="w"> </span><span class="p">(</span><span class="n">area_ID</span><span class="p">,</span><span class="w"> </span><span class="n">area_NAME</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">'Wood'</span><span class="p">);</span>
<span class="k">INSERT</span><span class="w"> </span><span class="mi">0</span><span class="w"> </span><span class="mi">1</span>
<span class="k">INSERT</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">HR</span><span class="p">.</span><span class="n">areaS</span><span class="w"> </span><span class="p">(</span><span class="n">area_ID</span><span class="p">,</span><span class="w"> </span><span class="n">area_NAME</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">2</span><span class="p">,</span><span class="w"> </span><span class="s1">'Lake'</span><span class="p">);</span>
<span class="k">INSERT</span><span class="w"> </span><span class="mi">0</span><span class="w"> </span><span class="mi">1</span>
<span class="k">INSERT</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">HR</span><span class="p">.</span><span class="n">areaS</span><span class="w"> </span><span class="p">(</span><span class="n">area_ID</span><span class="p">,</span><span class="w"> </span><span class="n">area_NAME</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">3</span><span class="p">,</span><span class="w"> </span><span class="s1">'Desert'</span><span class="p">);</span>
<span class="k">INSERT</span><span class="w"> </span><span class="mi">0</span><span class="w"> </span><span class="mi">1</span>
<span class="k">INSERT</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">HR</span><span class="p">.</span><span class="n">areaS</span><span class="w"> </span><span class="p">(</span><span class="n">area_ID</span><span class="p">,</span><span class="w"> </span><span class="n">area_NAME</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">4</span><span class="p">,</span><span class="w"> </span><span class="s1">'Iron'</span><span class="p">);</span>
<span class="k">INSERT</span><span class="w"> </span><span class="mi">0</span><span class="w"> </span><span class="mi">1</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001188521082__en-us_topic_0000001188680968_en-us_topic_0000001098970314_a7a1d57dcc4dd4fe8a6b31bd25ca0daa0">Change the prompt.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188521082__en-us_topic_0000001188680968_en-us_topic_0000001098970314_sc44b0f1b5231498d94ff386353e5ccaf"><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="err">\</span><span class="k">set</span><span class="w"> </span><span class="n">PROMPT1</span><span class="w"> </span><span class="s1">'%n@%m %~%R%#'</span>
<span class="n">dbadmin</span><span class="o">@</span><span class="p">[</span><span class="k">local</span><span class="p">]</span><span class="w"> </span><span class="n">postgres</span><span class="o">=#</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001188521082__en-us_topic_0000001188680968_en-us_topic_0000001098970314_aecac50698f304b479baff403296d682a">View the table.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188521082__en-us_topic_0000001188680968_en-us_topic_0000001098970314_s9f42b279160b4d1a84cb9dc2ac1af325"><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="n">dbadmin</span><span class="o">@</span><span class="p">[</span><span class="k">local</span><span class="p">]</span><span class="w"> </span><span class="n">postgres</span><span class="o">=#</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">HR</span><span class="p">.</span><span class="n">areaS</span><span class="p">;</span>
<span class="w"> </span><span class="n">area_id</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">area_name</span><span class="w"> </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">Wood</span>
<span class="w"> </span><span class="mi">4</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">Iron</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">Lake</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">Desert</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_0000001188521082__en-us_topic_0000001188680968_en-us_topic_0000001098970314_a5b3d7e106ecf48fcbf2da46d614b6528">Run the <strong id="EN-US_TOPIC_0000001188521082__en-us_topic_0000001188680968_en-us_topic_0000001098970314_b6590171224611">\pset</strong> command to display the table in different ways.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188521082__en-us_topic_0000001188680968_en-us_topic_0000001098970314_sd366ca28b3d644e7a57d17dcb30eb6af"><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></pre></div></td><td class="code"><div><pre><span></span><span class="n">dbadmin</span><span class="o">@</span><span class="p">[</span><span class="k">local</span><span class="p">]</span><span class="w"> </span><span class="n">postgres</span><span class="o">=#</span><span class="err">\</span><span class="n">pset</span><span class="w"> </span><span class="n">border</span><span class="w"> </span><span class="mi">2</span>
<span class="n">Border</span><span class="w"> </span><span class="n">style</span><span class="w"> </span><span class="k">is</span><span class="w"> </span><span class="mi">2</span><span class="p">.</span>
<span class="n">dbadmin</span><span class="o">@</span><span class="p">[</span><span class="k">local</span><span class="p">]</span><span class="w"> </span><span class="n">postgres</span><span class="o">=#</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">HR</span><span class="p">.</span><span class="n">areaS</span><span class="p">;</span>
<span class="o">+</span><span class="c1">---------+------------------------+</span>
<span class="o">|</span><span class="w"> </span><span class="n">area_id</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">area_name</span><span class="w"> </span><span class="o">|</span>
<span class="o">+</span><span class="c1">---------+------------------------+</span>
<span class="o">|</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">Wood</span><span class="w"> </span><span class="o">|</span>
<span class="o">|</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">Lake</span><span class="w"> </span><span class="o">|</span>
<span class="o">|</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">Desert</span><span class="w"> </span><span class="o">|</span>
<span class="o">|</span><span class="w"> </span><span class="mi">4</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">Iron</span><span class="w"> </span><span class="o">|</span>
<span class="o">+</span><span class="c1">---------+------------------------+</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>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188521082__en-us_topic_0000001188680968_en-us_topic_0000001098970314_se74b5b117364466db123270928fa8c0f"><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></pre></div></td><td class="code"><div><pre><span></span><span class="n">dbadmin</span><span class="o">@</span><span class="p">[</span><span class="k">local</span><span class="p">]</span><span class="w"> </span><span class="n">postgres</span><span class="o">=#</span><span class="err">\</span><span class="n">pset</span><span class="w"> </span><span class="n">border</span><span class="w"> </span><span class="mi">0</span>
<span class="n">Border</span><span class="w"> </span><span class="n">style</span><span class="w"> </span><span class="k">is</span><span class="w"> </span><span class="mi">0</span><span class="p">.</span>
<span class="n">dbadmin</span><span class="o">@</span><span class="p">[</span><span class="k">local</span><span class="p">]</span><span class="w"> </span><span class="n">postgres</span><span class="o">=#</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">HR</span><span class="p">.</span><span class="n">areaS</span><span class="p">;</span>
<span class="n">area_id</span><span class="w"> </span><span class="n">area_name</span><span class="w"> </span>
<span class="c1">------- ----------------------</span>
<span class="w"> </span><span class="mi">1</span><span class="w"> </span><span class="n">Wood</span>
<span class="w"> </span><span class="mi">2</span><span class="w"> </span><span class="n">Lake</span>
<span class="w"> </span><span class="mi">3</span><span class="w"> </span><span class="n">Desert</span>
<span class="w"> </span><span class="mi">4</span><span class="w"> </span><span class="n">Iron</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_0000001188521082__en-us_topic_0000001188680968_en-us_topic_0000001098970314_a5807b39525f34aaeb32c6d61dd52ccf0">Use the meta-command.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188521082__en-us_topic_0000001188680968_en-us_topic_0000001098970314_sd41022af554744a0b43ac49159f4e038"><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="n">dbadmin</span><span class="o">@</span><span class="p">[</span><span class="k">local</span><span class="p">]</span><span class="w"> </span><span class="n">postgres</span><span class="o">=#</span><span class="err">\</span><span class="n">a</span><span class="w"> </span><span class="err">\</span><span class="n">t</span><span class="w"> </span><span class="err">\</span><span class="n">x</span>
<span class="k">Output</span><span class="w"> </span><span class="n">format</span><span class="w"> </span><span class="k">is</span><span class="w"> </span><span class="n">unaligned</span><span class="p">.</span>
<span class="n">Showing</span><span class="w"> </span><span class="k">only</span><span class="w"> </span><span class="n">tuples</span><span class="p">.</span>
<span class="n">Expanded</span><span class="w"> </span><span class="n">display</span><span class="w"> </span><span class="k">is</span><span class="w"> </span><span class="k">on</span><span class="p">.</span>
<span class="n">dbadmin</span><span class="o">@</span><span class="p">[</span><span class="k">local</span><span class="p">]</span><span class="w"> </span><span class="n">postgres</span><span class="o">=#</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">HR</span><span class="p">.</span><span class="n">areaS</span><span class="p">;</span>
<span class="n">area_id</span><span class="o">|</span><span class="mi">2</span>
<span class="n">area_name</span><span class="o">|</span><span class="n">Lake</span>
<span class="n">area_id</span><span class="o">|</span><span class="mi">1</span>
<span class="n">area_name</span><span class="o">|</span><span class="n">Wood</span>
<span class="n">area_id</span><span class="o">|</span><span class="mi">4</span>
<span class="n">area_name</span><span class="o">|</span><span class="n">Iron</span>
<span class="n">area_id</span><span class="o">|</span><span class="mi">3</span>
<span class="n">area_name</span><span class="o">|</span><span class="n">Desert</span>
<span class="n">dbadmin</span><span class="o">@</span><span class="p">[</span><span class="k">local</span><span class="p">]</span><span class="w"> </span><span class="n">postgres</span><span class="o">=#</span>
</pre></div></td></tr></table></div>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_gsql_index.html">gsql</a></div>
</div>
</div>
View Git Blame Copy Permalink