vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/dws/umn/dws_01_0107.html
Lu, Huayi 95132e24fc DWS UMN 830.201_new version 
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Reviewed-by: Rechenburg, Matthias <matthias.rechenburg@t-systems.com>
Co-authored-by: Lu, Huayi <luhuayi@huawei.com>
Co-committed-by: Lu, Huayi <luhuayi@huawei.com>
2024-05-27 11:54:34 +00:00

153 lines
27 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001707254513"></a><a name="EN-US_TOPIC_0000001707254513"></a>
<h1 class="topictitle1">Step 3: Connecting to a Cluster</h1>
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_section6082040915224"><h4 class="sectiontitle">Scenario</h4><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p533529515256">This section describes how to use a database client to connect to the database in a GaussDB(DWS) cluster. In the following example, the Data Studio client tool is used for connection through the public network address. You can also use other SQL clients to connect to the cluster. For more connection methods, see <a href="dws_01_0137.html">Methods of Connecting to a Cluster</a>.</p>
<ol id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_ol1131365102135"><li id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_li6884192062018">Obtain the name, username, and password of the database to be connected.<p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p2408234205"><a name="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_li6884192062018"></a><a name="en-us_topic_0000001423159613_li6884192062018"></a>If you use the client to connect to the cluster for the first time, use the administrator username and password set in <a href="dws_01_0013.html">Step 2: Creating a Cluster</a> to connect to the default database <span class="parmvalue" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_parmvalue135411726164018"><b><span id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_text171906415556">gaussdb</span></b></span>.</p>
</li><li id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_li29704753122535"><a href="#EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_section2301113635">Obtaining the Public Network Address of the Cluster</a>: Connect to the cluster database using the public network address.</li><li id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_li11594561122535"><a href="#EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_section99729517811">Connecting to the Cluster Database Using Data Studio</a>: Download and configure the Data Studio client and connect to the cluster database.</li></ol>
</div>
<div class="section" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_section2301113635"><a name="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_section2301113635"></a><a name="en-us_topic_0000001423159613_section2301113635"></a><h4 class="sectiontitle">Obtaining the Public Network Address of the Cluster</h4><ol id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_ol430273838"><li id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_li1630211312315"><span>Log in to the GaussDB(DWS) management console.</span></li><li id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_li18302336310"><span>In the navigation pane on the left, choose <span class="uicontrol" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_uicontrol13304836319"><b>Clusters &gt; Dedicated Clusters</b></span>.</span></li><li id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_li4308203433"><span>In the cluster list, select a created cluster (for example, <strong id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_b56348177398">dws-demo</strong>) and click <span><img id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_image11308238317" src="figure/en-us_image_0000001231470859.png"></span> next to the cluster name to obtain the public network address.</span><p><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p103081731439">The public network address will be used in <a href="#EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_section99729517811">Connecting to the Cluster Database Using Data Studio</a>.</p>
<div class="fignone" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_fig19228787245"><span class="figcap"><b>Figure 1 </b>Cluster management</span><br><span><img id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_image10228882243" src="figure/en-us_image_0000001185831246.png" title="Click to enlarge" class="imgResize"></span></div>
</p></li></ol>
</div>
<div class="section" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_section99729517811"><a name="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_section99729517811"></a><a name="en-us_topic_0000001423159613_section99729517811"></a><h4 class="sectiontitle">Connecting to the Cluster Database Using Data Studio</h4><ol id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_ol1272916211896"><li id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_li1689715193210"><span>GaussDB(DWS) provides a Windows-based Data Studio GUI client. The tool depends on JDK, so you must install Java 1.8.0_141 or later on the client host.</span><p><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p16185144111328">In the Windows operating system, you can download the required JDK version from the official website of JDK, and install it by following the installation guide.</p>
</p></li><li id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_li7589648964"><span>Log in to the GaussDB(DWS) management console.</span></li><li id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_li25411875155123"><span>Click <span class="uicontrol" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_uicontrol62465762165050"><b>Client Connections</b></span>.</span></li><li id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_li50432353163955"><span>On the <span class="parmname" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_parmname459516465105122"><b>Download Client and Driver</b></span> page, download <span class="uicontrol" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_uicontrol1449361985105231"><b>Data Studio GUI Client</b></span>.</span><p><ul id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_ul5379145911011"><li id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_li437955918109">Select <span class="parmvalue" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_parmvalue71264539443"><b>Windows x86</b></span> or <span class="parmvalue" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_parmvalue121321533445"><b>Windows x64</b></span> based on the operating system type and click <strong id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_b91331453124411">Download</strong> to download the Data Studio tool matching the current cluster version.<p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p15770142065620">If clusters of different versions are available, you will download the Data Studio tool matching the earliest cluster version after clicking <strong id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_b107083129487">Download</strong>. If there is no cluster, you will download the Data Studio tool of the earliest version after clicking <strong id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_b6717914917">Download</strong>. GaussDB(DWS) clusters are compatible with earlier versions of Data Studio tools.</p>
</li><li id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_li153801659161012">Click <strong id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_b16543201132817">Historical Version</strong> to download the corresponding Data Studio version. You are advised to download the Data Studio based on the cluster version.</li></ul>
<div class="fignone" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_fig2080103812115"><span class="figcap"><b>Figure 2 </b>Downloading clients</span><br><span><img id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_image4359505313" src="figure/en-us_image_0000001231470861.png" title="Click to enlarge" class="imgResize"></span></div>
</p></li><li id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_li18379727125913"><span>Decompress the downloaded client software package (32-bit or 64-bit) to the installation directory.</span></li><li id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_li9888125505914"><span>Open the installation directory and double-click <strong id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_b84235270610554">Data Studio.exe</strong> to start the Data Studio client. See <a href="#EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_fig6324139192412">Figure 3</a>.</span><p><div class="fignone" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_fig6324139192412"><a name="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_fig6324139192412"></a><a name="en-us_topic_0000001423159613_fig6324139192412"></a><span class="figcap"><b>Figure 3 </b>Starting the client</span><br><span><img id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_image43246942417" src="figure/en-us_image_0000001185831248.png"></span></div>
</p></li><li id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_li19435181292816"><span>Choose <strong id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_b091865916141">File</strong> &gt; <strong id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_b13990132201515">New Connection</strong> from the main menu. See <a href="#EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_fig14311312192811">Figure 4</a>.</span><p><div class="fignone" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_fig14311312192811"><a name="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_fig14311312192811"></a><a name="en-us_topic_0000001423159613_fig14311312192811"></a><span class="figcap"><b>Figure 4 </b>Creating a connection</span><br><span><img id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_image1163017491494" src="figure/en-us_image_0000001231470865.png"></span></div>
</p></li><li id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_li9560830912"><span>In the displayed <span class="uicontrol" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_uicontrol809566054103124"><b>New Database Connection</b></span> window, enter the connection parameters.</span><p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_table79217143912" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Connection parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_row88417113910"><th align="left" class="cellrowborder" valign="top" width="23.232323232323232%" id="mcps1.3.3.2.8.2.1.2.4.1.1"><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p167171710393"><strong id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_b842352706103219">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="43.43434343434344%" id="mcps1.3.3.2.8.2.1.2.4.1.2"><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p9741716392"><strong id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_b842352706103223">Description</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.2.8.2.1.2.4.1.3"><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p88171713915"><strong id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_b842352706103227">Example</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_row1816716134011"><td class="cellrowborder" valign="top" width="23.232323232323232%" headers="mcps1.3.3.2.8.2.1.2.4.1.1 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p51683131702">Database Type</p>
</td>
<td class="cellrowborder" valign="top" width="43.43434343434344%" headers="mcps1.3.3.2.8.2.1.2.4.1.2 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p1681682202411">Select <strong id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_b16400857121415">GaussDB A</strong>.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.8.2.1.2.4.1.3 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p15551115172418">GaussDB A</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_row138017153913"><td class="cellrowborder" valign="top" width="23.232323232323232%" headers="mcps1.3.3.2.8.2.1.2.4.1.1 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p38131716399">Connection Name</p>
</td>
<td class="cellrowborder" valign="top" width="43.43434343434344%" headers="mcps1.3.3.2.8.2.1.2.4.1.2 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p7813171399">Name of a connection</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.8.2.1.2.4.1.3 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p11813172392">dws-demo</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_row178141710395"><td class="cellrowborder" valign="top" width="23.232323232323232%" headers="mcps1.3.3.2.8.2.1.2.4.1.1 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p12812176393">Host</p>
</td>
<td class="cellrowborder" valign="top" width="43.43434343434344%" headers="mcps1.3.3.2.8.2.1.2.4.1.2 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p38191720395">IP address (IPv4) or domain name of the cluster to be connected</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.8.2.1.2.4.1.3 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p88617143914">-</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_row88151717394"><td class="cellrowborder" valign="top" width="23.232323232323232%" headers="mcps1.3.3.2.8.2.1.2.4.1.1 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p88017123920">Host Port</p>
</td>
<td class="cellrowborder" valign="top" width="43.43434343434344%" headers="mcps1.3.3.2.8.2.1.2.4.1.2 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p2861717396">Database port</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.8.2.1.2.4.1.3 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p3812176392">8000</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_row9881783912"><td class="cellrowborder" valign="top" width="23.232323232323232%" headers="mcps1.3.3.2.8.2.1.2.4.1.1 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p158161773917">Database Name</p>
</td>
<td class="cellrowborder" valign="top" width="43.43434343434344%" headers="mcps1.3.3.2.8.2.1.2.4.1.2 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p48111711396">Database name</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.8.2.1.2.4.1.3 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p1515922133819"><span id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_text14944162893811">gaussdb</span></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_row79151714394"><td class="cellrowborder" valign="top" width="23.232323232323232%" headers="mcps1.3.3.2.8.2.1.2.4.1.1 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p081117133920">User Name</p>
</td>
<td class="cellrowborder" valign="top" width="43.43434343434344%" headers="mcps1.3.3.2.8.2.1.2.4.1.2 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p10911171395">Username for connecting to the database</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.8.2.1.2.4.1.3 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p10991783915">-</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_row18961717397"><td class="cellrowborder" valign="top" width="23.232323232323232%" headers="mcps1.3.3.2.8.2.1.2.4.1.1 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p1391917163910">Password</p>
</td>
<td class="cellrowborder" valign="top" width="43.43434343434344%" headers="mcps1.3.3.2.8.2.1.2.4.1.2 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p149101753912">Password for logging in to the database to be connected</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.8.2.1.2.4.1.3 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p9921719399">-</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_row86069127252"><td class="cellrowborder" valign="top" width="23.232323232323232%" headers="mcps1.3.3.2.8.2.1.2.4.1.1 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p3607121212519">Save Password</p>
</td>
<td class="cellrowborder" valign="top" width="43.43434343434344%" headers="mcps1.3.3.2.8.2.1.2.4.1.2 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p17607111212511">Select an option from the drop-down list:</p>
<ul id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_ul37500309263"><li id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_li15750830162613"><strong id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_b477034651103528"><span class="uicontrol" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_uicontrol570447197103528"><b>Current Session Only</b></span></strong>: The password is saved only in the current session.</li><li id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_li119112407267"><strong id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_b209892631103614"><span class="uicontrol" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_uicontrol572652108103614"><b>Do Not Save</b></span></strong>: The password is not saved.</li></ul>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.8.2.1.2.4.1.3 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p5607512192513">-</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_row1380819420192"><td class="cellrowborder" valign="top" width="23.232323232323232%" headers="mcps1.3.3.2.8.2.1.2.4.1.1 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p880824281913">Enable SSL</p>
</td>
<td class="cellrowborder" valign="top" width="43.43434343434344%" headers="mcps1.3.3.2.8.2.1.2.4.1.2 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p1480994211197">If <strong id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_b79131545201112">Enable SSL</strong> is selected, the client can use SSL to encrypt connections. The SSL mode is more secure than common modes, so you are advised to enable SSL connection.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.8.2.1.2.4.1.3 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p280954217195">-</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p1623861016240">If <strong id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_b1737216473913">Enable SSL</strong> is selected, download and decompress the SSL certificate. For details, see <a href="dws_01_0038.html#EN-US_TOPIC_0000001659054490__en-us_topic_0000001372520154_li13478842115911">Downloading the SSL Cert...</a>. Click the <strong id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_b1765131118355">SSL</strong> tab and configure the following parameters:</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_table1512855203112" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Configuring SSL parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_row171317551318"><th align="left" class="cellrowborder" valign="top" width="19.38%" id="mcps1.3.3.2.8.2.3.2.3.1.1"><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p18131955133117"><strong id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_b164915573810">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="80.62%" id="mcps1.3.3.2.8.2.3.2.3.1.2"><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p19137554319"><strong id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_b5976202942113">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_row61425513112"><td class="cellrowborder" valign="top" width="19.38%" headers="mcps1.3.3.2.8.2.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p1514955133113">Client SSL Certificate</p>
</td>
<td class="cellrowborder" valign="top" width="80.62%" headers="mcps1.3.3.2.8.2.3.2.3.1.2 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p3141055193115">Select the <span class="filepath" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_filepath13178154343514"><b>sslcert\client.crt</b></span> file in the decompressed SSL certificate directory.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_row15151555123117"><td class="cellrowborder" valign="top" width="19.38%" headers="mcps1.3.3.2.8.2.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p121516558317">Client SSL Key</p>
</td>
<td class="cellrowborder" valign="top" width="80.62%" headers="mcps1.3.3.2.8.2.3.2.3.1.2 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p7151255113113">Only the PK8 format is supported. Select the <strong id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_b2138239131414">sslcert\client.key.pk8</strong> file in the directory where the SSL certificate is decompressed.</p>
<p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p8531535123613"></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_row15151655103110"><td class="cellrowborder" valign="top" width="19.38%" headers="mcps1.3.3.2.8.2.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p91575583118">Root Certificate</p>
</td>
<td class="cellrowborder" valign="top" width="80.62%" headers="mcps1.3.3.2.8.2.3.2.3.1.2 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p1531243911409">When <span class="parmname" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_parmname1920294962414"><b>SSL Mode</b></span> is set to <span class="parmvalue" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_parmvalue5203649162411"><b>verify-ca</b></span>, the root certificate must be configured. Select the <span class="filepath" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_filepath22031049172412"><b>sslcert\cacert.pem</b></span> file in the decompressed SSL certificate directory.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_row51625510311"><td class="cellrowborder" valign="top" width="19.38%" headers="mcps1.3.3.2.8.2.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p516125517315">SSL Password</p>
</td>
<td class="cellrowborder" valign="top" width="80.62%" headers="mcps1.3.3.2.8.2.3.2.3.1.2 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p21655516313">Set the password for the client SSL key in PK8 format.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_row1916155583118"><td class="cellrowborder" valign="top" width="19.38%" headers="mcps1.3.3.2.8.2.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p616115515312">SSL Mode</p>
</td>
<td class="cellrowborder" valign="top" width="80.62%" headers="mcps1.3.3.2.8.2.3.2.3.1.2 "><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p1380624518403">Supported SSL modes include:</p>
<ul id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_ul174486715440"><li id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_li1144811717445">require</li><li id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_li10448157184411">verify-ca</li></ul>
<p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p10351254114217">GaussDB(DWS) does not support the <span class="parmvalue" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_parmvalue11879175512423"><b>verify-full</b></span> mode.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="fignone" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_fig2491192219469"><span class="figcap"><b>Figure 5 </b>Configuring SSL parameters</span><br><span><img id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_image13546122811216" src="figure/en-us_image_0000001186149724.png" title="Click to enlarge" class="imgResize"></span></div>
</p></li><li id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_li181020421385"><span>Click <strong id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_b84235270611160">OK</strong> to establish the database connection.</span><p><p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p163341713161311">If SSL is enabled, click <strong id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_b6650224071610">Continue</strong> in the displayed <span class="wintitle" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_wintitle65012128611463"><b>Connection Security Alert</b></span> dialog box.</p>
<p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p85509113378">After the login is successful, the <span class="wintitle" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_wintitle8590133204815"><b>RECENT LOGIN ACTIVITY</b></span> dialog box is displayed, indicating that Data Studio is connected to the database. You can run the SQL statement in the <span class="menucascade" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_menucascade572978993114956"><b><span class="uicontrol" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_uicontrol952811128114956">SQL Terminal</span></b></span> window on the Data Studio page.</p>
<div class="fignone" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_fig1860617443213"><span class="figcap"><b>Figure 6 </b>Successful login</span><br><span><img id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_image106067433210" src="figure/en-us_image_0000001231629433.png"></span></div>
<p id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_p1792201115158">For details about how to use other functions of Data Studio, press <span class="uicontrol" id="EN-US_TOPIC_0000001707254513__en-us_topic_0000001423159613_uicontrol263500743165849"><b>F1</b></span> to view the Data Studio user manual.</p>
</p></li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_01_0078.html">Getting Started</a></div>
</div>
</div>
<script language="JavaScript">
<!--
image_size('.imgResize');
var msg_imageMax = "view original image";
var msg_imageClose = "close";
//--></script>
View Git Blame Copy Permalink