doc-exports/docs/dws/tool/dws_07_0001.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

89 lines
10 KiB
HTML

<a name="EN-US_TOPIC_0000001233800667"></a><a name="EN-US_TOPIC_0000001233800667"></a>
<h1 class="topictitle1">Overview</h1>
<div id="body1538121754285"><p id="EN-US_TOPIC_0000001233800667__p16147347173520">This document describes how to use GaussDB(DWS) tools, including client tools, as shown in <a href="#EN-US_TOPIC_0000001233800667__table138932093610">Table 1</a>, and server tools, as shown in <a href="#EN-US_TOPIC_0000001233800667__table1139657195412">Table 2</a>.</p>
<p id="EN-US_TOPIC_0000001233800667__p10548815183616">The client tools can be obtained by referring to <a href="dws_07_0002.html">Downloading Related Tools</a>.</p>
<p id="EN-US_TOPIC_0000001233800667__p124841611143712">The server tools are stored in the <strong id="EN-US_TOPIC_0000001233800667__b384553714517">$GPHOME/script</strong> and <strong id="EN-US_TOPIC_0000001233800667__b5852183754517">$GAUSSHOME/bin</strong> paths on the database server.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001233800667__table138932093610"></a><a name="table138932093610"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001233800667__table138932093610" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Client Tools</caption><thead align="left"><tr id="EN-US_TOPIC_0000001233800667__row159072033620"><th align="left" class="cellrowborder" valign="top" width="22.55%" id="mcps1.3.4.2.3.1.1"><p id="EN-US_TOPIC_0000001233800667__p1690142018369">Tool</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="77.45%" id="mcps1.3.4.2.3.1.2"><p id="EN-US_TOPIC_0000001233800667__p790192018366">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001233800667__row1990182010365"><td class="cellrowborder" valign="top" width="22.55%" headers="mcps1.3.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001233800667__p199052083613">gsql</p>
</td>
<td class="cellrowborder" valign="top" width="77.45%" headers="mcps1.3.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001233800667__p109022063614">A command-line interface (CLI) SQL client tool running on the Linux OS. It is used to connect to the database in a GaussDB(DWS) cluster and perform operation and maintenance on the database.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233800667__row1190182011369"><td class="cellrowborder" valign="top" width="22.55%" headers="mcps1.3.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001233800667__p10901520103613">Data Studio</p>
</td>
<td class="cellrowborder" valign="top" width="77.45%" headers="mcps1.3.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001233800667__p17901020153612">A client tool used to connect to a database. It provides a GUI for managing databases and objects, editing, executing, and debugging SQL scripts, and viewing execution plans. Data Studio can run on a 32-bit or 64-bit Windows OS. You can use it after decompression without installation.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233800667__row179142016369"><td class="cellrowborder" valign="top" width="22.55%" headers="mcps1.3.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001233800667__p39172023610">GDS</p>
</td>
<td class="cellrowborder" valign="top" width="77.45%" headers="mcps1.3.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001233800667__p79152023616">A CLI tool running on the Linux OS. It works with foreign tables to quickly import and export data. The GDS tool package needs to be installed on the server where the data source file is located. This server is called the data server or the GDS server.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233800667__row14911420133612"><td class="cellrowborder" valign="top" width="22.55%" headers="mcps1.3.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001233800667__p129192013368">DSC</p>
</td>
<td class="cellrowborder" valign="top" width="77.45%" headers="mcps1.3.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001233800667__p89172073610">A CLI tool used for migrating SQL scripts from Teradata or Oracle to GaussDB(DWS) to rebuild a database on GaussDB(DWS). DSC runs on the Linux OS. You can use it after decompression without installation.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001233800667__table1139657195412"></a><a name="table1139657195412"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001233800667__table1139657195412" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Server Tools</caption><thead align="left"><tr id="EN-US_TOPIC_0000001233800667__en-us_topic_0000001188362620_en-us_topic_0000001098970664_row11292239115117"><th align="left" class="cellrowborder" valign="top" width="28.38%" id="mcps1.3.5.2.3.1.1"><p id="EN-US_TOPIC_0000001233800667__en-us_topic_0000001188362620_en-us_topic_0000001098970664_p16292113925120">Tool</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="71.61999999999999%" id="mcps1.3.5.2.3.1.2"><p id="EN-US_TOPIC_0000001233800667__en-us_topic_0000001188362620_en-us_topic_0000001098970664_p1529263985118">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001233800667__en-us_topic_0000001188362620_en-us_topic_0000001098970664_row1624695820115"><td class="cellrowborder" valign="top" width="28.38%" headers="mcps1.3.5.2.3.1.1 "><p id="EN-US_TOPIC_0000001233800667__en-us_topic_0000001188362620_en-us_topic_0000001098970664_p16246145815114"><a href="dws_07_0101.html">gs_dump</a></p>
</td>
<td class="cellrowborder" valign="top" width="71.61999999999999%" headers="mcps1.3.5.2.3.1.2 "><p id="EN-US_TOPIC_0000001233800667__en-us_topic_0000001188362620_en-us_topic_0000001098970664_p589185483411">gs_dump exports database information, such as the complete and consistent data of database objects (including databases, schemas, tables, and views), without affecting the normal access of users to the database.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233800667__en-us_topic_0000001188362620_en-us_topic_0000001098970664_row54209567117"><td class="cellrowborder" valign="top" width="28.38%" headers="mcps1.3.5.2.3.1.1 "><p id="EN-US_TOPIC_0000001233800667__en-us_topic_0000001188362620_en-us_topic_0000001098970664_p1942035618119"><a href="dws_07_0102.html">gs_dumpall</a></p>
</td>
<td class="cellrowborder" valign="top" width="71.61999999999999%" headers="mcps1.3.5.2.3.1.2 "><p id="EN-US_TOPIC_0000001233800667__en-us_topic_0000001188362620_en-us_topic_0000001098970664_p14201756319">gs_dumpall exports database information, such as the complete and consistent data of database objects, without affecting the normal access of users to the database.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233800667__en-us_topic_0000001188362620_en-us_topic_0000001098970664_row179461229712"><td class="cellrowborder" valign="top" width="28.38%" headers="mcps1.3.5.2.3.1.1 "><p id="EN-US_TOPIC_0000001233800667__en-us_topic_0000001188362620_en-us_topic_0000001098970664_p13946142914116"><a href="dws_07_0103.html">gs_restore</a></p>
</td>
<td class="cellrowborder" valign="top" width="71.61999999999999%" headers="mcps1.3.5.2.3.1.2 "><p id="EN-US_TOPIC_0000001233800667__en-us_topic_0000001188362620_en-us_topic_0000001098970664_a8a505b1ce23e4f29bdf9ab45da07de1f">gs_restore is a tool provided by <span id="EN-US_TOPIC_0000001233800667__text1827871714138">GaussDB(DWS)</span> to import data that is exported using gs_dump. It can also be used to import files that were exported using <strong id="EN-US_TOPIC_0000001233800667__b19563101831313">gs_dump</strong>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233800667__en-us_topic_0000001188362620_row16783101517319"><td class="cellrowborder" valign="top" width="28.38%" headers="mcps1.3.5.2.3.1.1 "><p id="EN-US_TOPIC_0000001233800667__en-us_topic_0000001188362620_p5783161510318"><a href="dws_07_0104.html">gds_check</a></p>
</td>
<td class="cellrowborder" valign="top" width="71.61999999999999%" headers="mcps1.3.5.2.3.1.2 "><p id="EN-US_TOPIC_0000001233800667__en-us_topic_0000001188362620_en-us_topic_0000001098650744_p783192916443">gds_check is used to check the GDS deployment environment, including the OS parameters, network environment, and disk usage. It also supports the recovery of system parameters. This helps detect potential problems during GDS deployment and running, improving the execution success rate.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233800667__en-us_topic_0000001188362620_row3205192216311"><td class="cellrowborder" valign="top" width="28.38%" headers="mcps1.3.5.2.3.1.1 "><p id="EN-US_TOPIC_0000001233800667__en-us_topic_0000001188362620_p1720562253112"><a href="dws_07_0106.html">gds_install</a></p>
</td>
<td class="cellrowborder" valign="top" width="71.61999999999999%" headers="mcps1.3.5.2.3.1.2 "><p id="EN-US_TOPIC_0000001233800667__en-us_topic_0000001188362620_p320616223319">gds_install is a script tool used to install GDS in batches, improving GDS deployment efficiency.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233800667__en-us_topic_0000001188362620_row26404278317"><td class="cellrowborder" valign="top" width="28.38%" headers="mcps1.3.5.2.3.1.1 "><p id="EN-US_TOPIC_0000001233800667__en-us_topic_0000001188362620_p7640527173111"><a href="dws_07_0107.html">gds_uninstall</a></p>
</td>
<td class="cellrowborder" valign="top" width="71.61999999999999%" headers="mcps1.3.5.2.3.1.2 "><p id="EN-US_TOPIC_0000001233800667__en-us_topic_0000001188362620_en-us_topic_0000001145650691_p986019352381">gds_uninstall is a script tool used to uninstall GDS in batches.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233800667__en-us_topic_0000001188362620_row364012717315"><td class="cellrowborder" valign="top" width="28.38%" headers="mcps1.3.5.2.3.1.1 "><p id="EN-US_TOPIC_0000001233800667__en-us_topic_0000001188362620_p13641182712315"><a href="dws_07_0105.html">gds_ctl</a></p>
</td>
<td class="cellrowborder" valign="top" width="71.61999999999999%" headers="mcps1.3.5.2.3.1.2 "><p id="EN-US_TOPIC_0000001233800667__en-us_topic_0000001188362620_p164114272315">gds_ctl is a script tool used for starting or stopping GDS service processes in batches. You can start or stop GDS service processes, which use the same port, on multiple nodes at a time, and set a daemon for each GDS process during the startup.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233800667__row48531213151916"><td class="cellrowborder" valign="top" width="28.38%" headers="mcps1.3.5.2.3.1.1 "><p id="EN-US_TOPIC_0000001233800667__p58534136193"><a href="dws_07_0108.html">gs_sshexkey</a></p>
</td>
<td class="cellrowborder" valign="top" width="71.61999999999999%" headers="mcps1.3.5.2.3.1.2 "><p id="EN-US_TOPIC_0000001233800667__p18531013151911">During cluster installation, you need to execute commands and transfer files among hosts in the cluster. gs_sshexkey is used to help users establish mutual trust.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>