vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/dws/umn/dws_01_0031.html
luhuayi 85562e1879 DWS UMN 831.100 version 
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Co-authored-by: luhuayi <luhuayi@huawei.com>
Co-committed-by: luhuayi <luhuayi@huawei.com>
2024-11-13 08:55:54 +00:00

83 lines
11 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001924569228"></a><a name="EN-US_TOPIC_0000001924569228"></a>
<h1 class="topictitle1">Downloading the Client</h1>
<div id="body1492143168050"><p id="EN-US_TOPIC_0000001924569228__p084514013113">GaussDB(DWS) provides client tool packages that match the cluster versions. You can download the desired client tool package on the GaussDB(DWS) management console. </p>
<p id="EN-US_TOPIC_0000001924569228__p181638390132">The client tool package contains the following:</p>
<ul id="EN-US_TOPIC_0000001924569228__ul19221210171418"><li id="EN-US_TOPIC_0000001924569228__li3935152512013"><strong id="EN-US_TOPIC_0000001924569228__b0444144619356">Linux database connection tool gsql and the script for testing sample data</strong><p id="EN-US_TOPIC_0000001924569228__p2571434171413">Linux gsql is a Linux command line client running in Linux. It is used to connect to the database in a data warehouse cluster.</p>
<p id="EN-US_TOPIC_0000001924569228__p1613923519198">The script for testing sample data is used to execute the introductory example.</p>
</li><li id="EN-US_TOPIC_0000001924569228__li14925110164916"><strong id="EN-US_TOPIC_0000001924569228__b10752101993614">Windows gsql</strong><p id="EN-US_TOPIC_0000001924569228__p592517109494">Windows gsql is a command line client running on the Windows OS. It is used to connect to the database in a data warehouse cluster.</p>
<div class="note" id="EN-US_TOPIC_0000001924569228__note1610933319412"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001924569228__p197458236215">Only 8.1.3.101 and later cluster versions can be downloaded from the console.</p>
</div></div>
</li><li id="EN-US_TOPIC_0000001924569228__li122341021417"><strong id="EN-US_TOPIC_0000001924569228__b84235270617464">GDS tool package</strong><p id="EN-US_TOPIC_0000001924569228__p1199612611505">Gauss Data Service (GDS) is a data service tool. You can use the GDS tool to import a data file in a common file system to the GaussDB(DWS) database. The GDS tool package must be installed on the server where the data source file is located. The server where the data source file is located is called a data server or GDS server.</p>
</li></ul>
<div class="section" id="EN-US_TOPIC_0000001924569228__section22966852154814"><h4 class="sectiontitle">Downloading the Client</h4><ol id="EN-US_TOPIC_0000001924569228__ol60386497154929"><li id="EN-US_TOPIC_0000001924569228__li115408565467"><span>Log in to the GaussDB(DWS) console.</span></li><li id="EN-US_TOPIC_0000001924569228__li25411875155123"><span>In the navigation tree on the left, choose <strong id="EN-US_TOPIC_0000001924569228__b393434044719">Management</strong> &gt; <strong id="EN-US_TOPIC_0000001924569228__b593524014719">Client Connections</strong>.</span></li><li id="EN-US_TOPIC_0000001924569228__li50432353163955"><span>Select the GaussDB(DWS) client of the corresponding version from the drop-down list of <strong id="EN-US_TOPIC_0000001924569228__b1466491113309"><span id="EN-US_TOPIC_0000001924569228__text0663161113012">gsql CLI</span></strong><strong id="EN-US_TOPIC_0000001924569228__b12664151113017"> Client</strong>.</span><p><p id="EN-US_TOPIC_0000001924569228__p53255496174429">Choose a corresponding client version according to the cluster version and operating system to which the client is to be installed.</p>
</p></li><li id="EN-US_TOPIC_0000001924569228__li1668501401317"><span>Click <span class="uicontrol" id="EN-US_TOPIC_0000001924569228__uicontrol2520533171315"><b>Download</b></span> to download the gsql tool matching the 8.1.x cluster version. Click <strong id="EN-US_TOPIC_0000001924569228__b227971010510">Historical Version</strong> to download the gsql tool corresponding to the cluster version.</span><p><ul id="EN-US_TOPIC_0000001924569228__ul145091214113919"><li id="EN-US_TOPIC_0000001924569228__li658334183216">You are advised to download the gsql tool that matches the cluster version. That is, use gsql 8.1.x for clusters of 8.1.0 or later, and use gsql 8.2.x for clusters of 8.2.0 or later.</li><li id="EN-US_TOPIC_0000001924569228__li17510191483915">The following table describes the files and folders in the Linux gsql tool package.
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001924569228__t8fecf5f1a1ff445ba5451382c11182a8" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Files and folders in the Linux gsql tool package</caption><thead align="left"><tr id="EN-US_TOPIC_0000001924569228__rcf6a7cd1410646c3acd6e06c0ccfca93"><th align="left" class="cellrowborder" valign="top" width="16.85%" id="mcps1.3.4.2.4.2.1.2.1.2.3.1.1"><p id="EN-US_TOPIC_0000001924569228__a2d989a0f459b4417bba469e9ed198487"><strong id="EN-US_TOPIC_0000001924569228__b69101326152320">File or Folder</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="83.15%" id="mcps1.3.4.2.4.2.1.2.1.2.3.1.2"><p id="EN-US_TOPIC_0000001924569228__aaeee215110904fd980f4d74fb697efa8"><strong id="EN-US_TOPIC_0000001924569228__b088613306237">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001924569228__r3fe1a64e58d840b68538183c0d634a44"><td class="cellrowborder" valign="top" width="16.85%" headers="mcps1.3.4.2.4.2.1.2.1.2.3.1.1 "><p id="EN-US_TOPIC_0000001924569228__a8a16b90d41ac422882ceb1df761fabca">bin</p>
</td>
<td class="cellrowborder" valign="top" width="83.15%" headers="mcps1.3.4.2.4.2.1.2.1.2.3.1.2 "><p id="EN-US_TOPIC_0000001924569228__p123406261119">This folder holds the Linux executable files for gsql, which include tools gsql, GDS, gs_dump, gs_dumpall, and gs_restore. For details, see <span id="EN-US_TOPIC_0000001924569228__ph8653105785712">"Server Tool"</span>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001924569228__r9403c771cae94e57b5c78dcbf033db71"><td class="cellrowborder" valign="top" width="16.85%" headers="mcps1.3.4.2.4.2.1.2.1.2.3.1.1 "><p id="EN-US_TOPIC_0000001924569228__en-us_topic_0167984001_p26124344180">gds</p>
</td>
<td class="cellrowborder" valign="top" width="83.15%" headers="mcps1.3.4.2.4.2.1.2.1.2.3.1.2 "><p id="EN-US_TOPIC_0000001924569228__a6e13c2b0c15a4c4f8c41015ec5674d75">This folder contains the files of the GDS data service tool. The GDS tool is used for parallel data loading and can import the data files stored in a common file system to a GaussDB(DWS) database.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001924569228__r8fa2f8f3ee034fad830ecc96be19d2c7"><td class="cellrowborder" valign="top" width="16.85%" headers="mcps1.3.4.2.4.2.1.2.1.2.3.1.1 "><p id="EN-US_TOPIC_0000001924569228__a4daca4a9648d4be28c33e7ca06195cad">lib</p>
</td>
<td class="cellrowborder" valign="top" width="83.15%" headers="mcps1.3.4.2.4.2.1.2.1.2.3.1.2 "><p id="EN-US_TOPIC_0000001924569228__a112b44845bf84b19a1a16faf8bbf57bf">This folder contains the <strong id="EN-US_TOPIC_0000001924569228__b173701618142811">lib</strong> library required for executing the gsql client.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001924569228__r8f8cba67c64f4653a2ce6c538ad47efa"><td class="cellrowborder" valign="top" width="16.85%" headers="mcps1.3.4.2.4.2.1.2.1.2.3.1.1 "><p id="EN-US_TOPIC_0000001924569228__en-us_topic_0167984001_p262033412186">sample</p>
</td>
<td class="cellrowborder" valign="top" width="83.15%" headers="mcps1.3.4.2.4.2.1.2.1.2.3.1.2 "><p id="EN-US_TOPIC_0000001924569228__p143194163914">This folder contains the following directories and files:</p>
<ul id="EN-US_TOPIC_0000001924569228__ul5636131718426"><li id="EN-US_TOPIC_0000001924569228__li26368171424"><strong id="EN-US_TOPIC_0000001924569228__b532919672915">setup.sh</strong>: script file for configuring the AK/SK before using gsql to import sample data</li><li id="EN-US_TOPIC_0000001924569228__li363615171420"><strong id="EN-US_TOPIC_0000001924569228__b1883144373019">tpcds_load_data_from_obs.sql</strong>: script file for importing the TPC-DS sample data using the gsql client</li><li id="EN-US_TOPIC_0000001924569228__li1163671754216"><strong id="EN-US_TOPIC_0000001924569228__b172233389324">query_sql</strong> directory: script file for querying the TPC-DS sample data</li></ul>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001924569228__r8751b7a9c87a4e149dbfb35b6744e2f3"><td class="cellrowborder" valign="top" width="16.85%" headers="mcps1.3.4.2.4.2.1.2.1.2.3.1.1 "><p id="EN-US_TOPIC_0000001924569228__a2d03bd9607494e44bf9680f3511d999f">gsql_env.sh</p>
</td>
<td class="cellrowborder" valign="top" width="83.15%" headers="mcps1.3.4.2.4.2.1.2.1.2.3.1.2 "><p id="EN-US_TOPIC_0000001924569228__a484ec47d1b2c4d57b9e5b81a1f4bbdb0">Script file for configuring environment variables before running the gsql client.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000001924569228__li399814403919">The following table describes the files and folders in the Windows gsql tool package.
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001924569228__table499884143912" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Files and folders in the Windows gsql tool package</caption><thead align="left"><tr id="EN-US_TOPIC_0000001924569228__row4998343398"><th align="left" class="cellrowborder" valign="top" width="16.85%" id="mcps1.3.4.2.4.2.1.3.1.2.3.1.1"><p id="EN-US_TOPIC_0000001924569228__p10998154183911"><strong id="EN-US_TOPIC_0000001924569228__b184487829">File or Folder</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="83.15%" id="mcps1.3.4.2.4.2.1.3.1.2.3.1.2"><p id="EN-US_TOPIC_0000001924569228__p599815483910"><strong id="EN-US_TOPIC_0000001924569228__b1230471511">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001924569228__row139993416393"><td class="cellrowborder" valign="top" width="16.85%" headers="mcps1.3.4.2.4.2.1.3.1.2.3.1.1 "><p id="EN-US_TOPIC_0000001924569228__p1499919413399">x64</p>
</td>
<td class="cellrowborder" valign="top" width="83.15%" headers="mcps1.3.4.2.4.2.1.3.1.2.3.1.2 "><p id="EN-US_TOPIC_0000001924569228__p199984183911">This folder contains the 64-bit Windows gsql execution binary file and the dynamic library.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001924569228__row199904193920"><td class="cellrowborder" valign="top" width="16.85%" headers="mcps1.3.4.2.4.2.1.3.1.2.3.1.1 "><p id="EN-US_TOPIC_0000001924569228__p15999542392">x86</p>
</td>
<td class="cellrowborder" valign="top" width="83.15%" headers="mcps1.3.4.2.4.2.1.3.1.2.3.1.2 "><p id="EN-US_TOPIC_0000001924569228__p119995418399">This folder contains the 32-bit Windows gsql execution binary file and the dynamic library.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="note" id="EN-US_TOPIC_0000001924569228__note179991412391"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001924569228__p9977184755815">In the cluster list on the <strong id="EN-US_TOPIC_0000001924569228__b812375433413">Clusters</strong> &gt; <strong id="EN-US_TOPIC_0000001924569228__b5141257103419">Dedicated Clusters<span id="EN-US_TOPIC_0000001924569228__text2747131595716"></span></strong> page, click the name of the specified cluster to go to the <span class="parmname" id="EN-US_TOPIC_0000001924569228__parmname14967340193413"><b>Cluster Information</b></span> page and view the cluster version.</p>
</div></div>
</li></ul>
</p></li></ol>
<p id="EN-US_TOPIC_0000001924569228__p10187110144511"></p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_01_0093.html">Using the gsql CLI Client to Connect to a Cluster</a></div>
</div>
</div>
View Git Blame Copy Permalink