forked from docs/doc-exports
luhuayi
a5e3903f6b
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com> Co-authored-by: luhuayi <luhuayi@huawei.com> Co-committed-by: luhuayi <luhuayi@huawei.com>
149 lines
30 KiB
HTML
149 lines
30 KiB
HTML
<a name="EN-US_TOPIC_0000001813598612"></a><a name="EN-US_TOPIC_0000001813598612"></a>
|
|
|
|
<h1 class="topictitle1">Connection Management</h1>
|
|
<div id="body8662426"><p class="msonormal" id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264704_p31118786">When Data Studio is started, the <strong id="EN-US_TOPIC_0000001813598612__b178128883716">New Database Connection</strong> dialog box is displayed by default. To perform database operations, Data Studio must be connected to at least one database.</p>
|
|
<p class="msonormal" id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264704_p11633618">Enter the connection parameters to create a database connection between Data Studio and the database server. Hover the mouse cursor over the connection name to view the database information.</p>
|
|
<div class="section" id="EN-US_TOPIC_0000001813598612__section6296113873912"><a name="EN-US_TOPIC_0000001813598612__section6296113873912"></a><a name="section6296113873912"></a><h4 class="sectiontitle">Adding a Connection</h4><ol id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_ol64325611"><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_li6790184110259"><span>Choose <strong id="EN-US_TOPIC_0000001813598612__b111032308382">File</strong> > <strong id="EN-US_TOPIC_0000001813598612__b156924320385">New Connection</strong> from the main menu, or click new connection icon on the toolbar. The <strong id="EN-US_TOPIC_0000001813598612__b1366182393920">New Database Connection</strong> dialog box is displayed.</span><p><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p94480365218"></p>
|
|
<p id="EN-US_TOPIC_0000001813598612__p62473261716"></p>
|
|
</p></li><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_li6896227"><span>The table on the left lists the details of the existing connection profile(s) used to connect to the database along with the server information.</span><p><p id="EN-US_TOPIC_0000001813598612__p187343720315">You can populate connection parameters, such as <strong id="EN-US_TOPIC_0000001813598612__b10290204119417">Connection Name</strong>, <strong id="EN-US_TOPIC_0000001813598612__b1729034174120">Host</strong>, and <strong id="EN-US_TOPIC_0000001813598612__b22909413413">Host Port</strong>, by double-clicking the connection name.</p>
|
|
<div class="note" id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_note19201622191515"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p9201722181511">If the password or key for any of the existing connections is damaged, you need to enter the password for whichever connection you use.</p>
|
|
</div></div>
|
|
</p></li><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_li7815975"><span>Configure the following parameters to create a database connection.</span><p>
|
|
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_table109756101700"></a><a name="en-us_topic_0185264624_table109756101700"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_table109756101700" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Database connection information</caption><thead align="left"><tr id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_row6246112016"><th align="left" class="cellrowborder" valign="top" width="23.232323232323232%" id="mcps1.3.3.2.3.2.1.2.4.1.1"><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p172461110019"><strong id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_b791184554513">Field</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="43.43434343434344%" id="mcps1.3.3.2.3.2.1.2.4.1.2"><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p52491114020"><strong id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_b3290114994510">Description</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.2.3.2.1.2.4.1.3"><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p162414111209"><strong id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_b192419526453">Example</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_row1439795510335"><td class="cellrowborder" valign="top" width="23.232323232323232%" headers="mcps1.3.3.2.3.2.1.2.4.1.1 "><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p188380155713">Database Type</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="43.43434343434344%" headers="mcps1.3.3.2.3.2.1.2.4.1.2 "><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p783820156710">Database type</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.3.2.1.2.4.1.3 "><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p35371625205312">-</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_row02417117015"><td class="cellrowborder" valign="top" width="23.232323232323232%" headers="mcps1.3.3.2.3.2.1.2.4.1.1 "><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p2024511002">Name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="43.43434343434344%" headers="mcps1.3.3.2.3.2.1.2.4.1.2 "><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p18241311306">Connection name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.3.2.1.2.4.1.3 "><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p172412114010">My_Connection_DB</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_row724711205"><td class="cellrowborder" valign="top" width="23.232323232323232%" headers="mcps1.3.3.2.3.2.1.2.4.1.1 "><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p16241411503">Host</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="43.43434343434344%" headers="mcps1.3.3.2.3.2.1.2.4.1.2 "><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p1245111017">Specifies the host IP address (IPv4) or database domain name.</p>
|
|
<div class="note" id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_note373061551111"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_ul332134212203"><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_li432084220201">If domain name length is greater than 25 characters, the complete domain name will not be displayed.<p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p18512134772014"><a name="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_li432084220201"></a><a name="en-us_topic_0185264624_li432084220201"></a>For example, <em id="EN-US_TOPIC_0000001813598612__i16199161417438">test1(db.dws…com:25xxx)</em> cannot be displayed completely.</p>
|
|
</li><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_li032114222013">Once the connection is created, hover the cursor over the connection name to see the server IP and version.</li><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_li832118429201">The value of this field will be identified as an IP address if it contains only digits with three periods (.). Otherwise, it will be identified as a domain name.</li><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_li1655814242619">A domain name must meet the following requirements:<ul id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_ul1389512498262"><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_li12321311163711">Start with a letter.</li><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_li11703816163713">Contains only letters, digits, hyphens (-), and periods (.) and cannot contain any other special character.</li><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_li11828183712375">Cannot contain spaces or tabs.</li><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_li225112351701">Contains 1 to 253 characters and a maximum of 63 characters between periods.</li></ul>
|
|
</li></ul>
|
|
</div></div>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.3.2.1.2.4.1.3 "><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p1248413313418">db.dws.mycloud.com</p>
|
|
<p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p460073420713">10.xx.xx.xx</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_row12461119017"><td class="cellrowborder" valign="top" width="23.232323232323232%" headers="mcps1.3.3.2.3.2.1.2.4.1.1 "><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p324151112019">Host Port</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="43.43434343434344%" headers="mcps1.3.3.2.3.2.1.2.4.1.2 "><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p3244117016">Provide the port address.</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.3.2.1.2.4.1.3 "><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p8241911806">8000</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_row72418111708"><td class="cellrowborder" valign="top" width="23.232323232323232%" headers="mcps1.3.3.2.3.2.1.2.4.1.1 "><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p18251511708">Databases</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="43.43434343434344%" headers="mcps1.3.3.2.3.2.1.2.4.1.2 "><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p52515111103">Specifies the database name.</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.3.2.1.2.4.1.3 "><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p925511707">gaussdb</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_row12254111011"><td class="cellrowborder" valign="top" width="23.232323232323232%" headers="mcps1.3.3.2.3.2.1.2.4.1.1 "><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p112518112016">Username</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="43.43434343434344%" headers="mcps1.3.3.2.3.2.1.2.4.1.2 "><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p6251411505">Provide the username to connect to the selected database.</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.3.2.1.2.4.1.3 "><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p82519112010">-</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_row1825511107"><td class="cellrowborder" valign="top" width="23.232323232323232%" headers="mcps1.3.3.2.3.2.1.2.4.1.1 "><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p1725131110017">Password</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="43.43434343434344%" headers="mcps1.3.3.2.3.2.1.2.4.1.2 "><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p182511111602">Specifies the password for connecting to the selected database. The password is masked.</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.3.2.1.2.4.1.3 "><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p62551119015">-</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001813598612__row0178142336"><td class="cellrowborder" valign="top" width="23.232323232323232%" headers="mcps1.3.3.2.3.2.1.2.4.1.1 "><p id="EN-US_TOPIC_0000001813598612__p16179141330">Save Password</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="43.43434343434344%" headers="mcps1.3.3.2.3.2.1.2.4.1.2 "><ul id="EN-US_TOPIC_0000001813598612__ul5535626203312"><li id="EN-US_TOPIC_0000001813598612__li8535102653313"><strong id="EN-US_TOPIC_0000001813598612__b16579111814505">Current Session Only</strong>: The password is saved only for the current session.</li><li id="EN-US_TOPIC_0000001813598612__li45351126133318"><strong id="EN-US_TOPIC_0000001813598612__b19333102425016">Do Not Save</strong>: The password is not saved.</li></ul>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.3.2.1.2.4.1.3 "><p id="EN-US_TOPIC_0000001813598612__p71795463310">-</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<div class="note" id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_note19053329297"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_ul421316387371"><li class="text" id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_li102131938133716">Click <strong id="EN-US_TOPIC_0000001813598612__b1049483165015">Clear</strong> to clear all fields in the <strong id="EN-US_TOPIC_0000001813598612__b174945319504">New Database Connection</strong> dialog box.</li><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_li14819173913374">Press <strong id="EN-US_TOPIC_0000001813598612__b19868174015018">Ctrl+V</strong> to paste data in the <strong id="EN-US_TOPIC_0000001813598612__b6868104025011">New Database Connection</strong> dialog box. Right-click options are not available in the dialog boxes of Data Studio.</li></ul>
|
|
</div></div>
|
|
</p></li><li id="EN-US_TOPIC_0000001813598612__li17775153118317"><span>Select the <strong id="EN-US_TOPIC_0000001813598612__b3768454155119">Enable SSL</strong> option and click the <strong id="EN-US_TOPIC_0000001813598612__b19408121205218">SSL</strong> tab. For details, see <a href="DWS_DS_008.html">Configuring SSL Connection</a>.</span><p><div class="fignone" id="EN-US_TOPIC_0000001813598612__fig7683711879"><span class="figcap"><b>Figure 1 </b>Configuring SSL parameters</span><br><span><img id="EN-US_TOPIC_0000001813598612__i232821e5252d4ed9b71faf166456bbba" src="figure/en-us_image_0000001813439300.png" width="465.5" height="232.044967" title="Click to enlarge" class="imgResize"></span></div>
|
|
</p></li><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_li13737131313504"><span>Perform the following steps to set <strong id="EN-US_TOPIC_0000001813598612__b1225312508532">Fast Load Options</strong>:</span><p><div class="p" id="EN-US_TOPIC_0000001813598612__p1951919514342">Click the <strong id="EN-US_TOPIC_0000001813598612__b15561719195419">Advanced</strong> tab.<div class="fignone" id="EN-US_TOPIC_0000001813598612__fig1377912249328"><span class="figcap"><b>Figure 2 </b>Configuring fast load options</span><br><span><img id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_image8586922182219" width="492.1" height="262.45328900000004" src="figure/en-us_image_0000001860319005.png" title="Click to enlarge" class="imgResize"></span></div>
|
|
</div>
|
|
<ul id="EN-US_TOPIC_0000001813598612__ul1262331412345"><li id="EN-US_TOPIC_0000001813598612__li186232143341">Enter the schema names separated by commas in the <strong id="EN-US_TOPIC_0000001813598612__b11658113655520">Include</strong> field to load these schemas preferentially.</li><li id="EN-US_TOPIC_0000001813598612__li189111249345">Enter the schema names separated by commas in the <strong id="EN-US_TOPIC_0000001813598612__b14617253135510">Exclude</strong> field to avoid loading these schemas preferentially.</li></ul>
|
|
<ul id="EN-US_TOPIC_0000001813598612__ul5629162920348"><li id="EN-US_TOPIC_0000001813598612__li12629172913344">Select either of the following options for <strong id="EN-US_TOPIC_0000001813598612__b163991359566">Load Objects</strong>:<ul id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_ul14206318020"><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_li420133111017"><strong id="EN-US_TOPIC_0000001813598612__b20124101175614">All Objects</strong>: Loads all objects.</li><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_li14203312015"><strong id="EN-US_TOPIC_0000001813598612__b3130142195615">Objects allowed as per user privilege</strong>: loads only objects that the user has permissions for accessing. For details about the minimum permissions for accessing objects listed in <strong id="EN-US_TOPIC_0000001813598612__b18580131195614">Object Browser</strong>, see <a href="dws_07_0012.html#EN-US_TOPIC_0000001860318645__en-us_topic_0185264599_table18121154132">Table 2</a>.</li></ul>
|
|
<div class="note" id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_note1022123118019"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p82220311002">The default value is <strong id="EN-US_TOPIC_0000001813598612__b15108804438916">Objects allowed as per user privilege</strong>.</p>
|
|
</div></div>
|
|
</li><li id="EN-US_TOPIC_0000001813598612__li17629929103418">Enter the number of database objects that can be loaded in <strong id="EN-US_TOPIC_0000001813598612__b15119113465719">Load Limit</strong>. The maximum number is 30,000.<div class="note" id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_note182333114017"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_ul62363119014"><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_li22213311016">If the number of object types (such as tables and views) of the schema entered in <strong id="EN-US_TOPIC_0000001813598612__b223431820587">Include</strong> is greater than the value of <strong id="EN-US_TOPIC_0000001813598612__b423481816588">Load Limit</strong>, only the parent objects of the schema will be loaded. This indicates that child objects containing more than three parameters will not be loaded, such as columns, constraints, indexes, and functions.</li><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_li1623183118016">Schema names provided in <strong id="EN-US_TOPIC_0000001813598612__b102625514591">Include</strong> and <strong id="EN-US_TOPIC_0000001813598612__b11263953596">Exclude</strong> are validated.</li></ul>
|
|
<ul id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_ul1023631407"><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_li112314317020">If you cannot access the schema specified in <strong id="EN-US_TOPIC_0000001813598612__b85171612596">Include</strong>, an error message of the schema will be displayed during connection.</li><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_li22363119017">If you cannot access the schema specified in <strong id="EN-US_TOPIC_0000001813598612__b12345122812592">Exclude</strong>, the schema will not be loaded in <strong id="EN-US_TOPIC_0000001813598612__b634616285599">Object Browser</strong> after the connection is created.</li></ul>
|
|
</div></div>
|
|
</li></ul>
|
|
</p></li><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_li515013439118"><span>Click <strong id="EN-US_TOPIC_0000001813598612__b14762103865915">OK</strong>.</span><p><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p1864718389214">The status bar displays the status of the completed operation.</p>
|
|
<p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p4865465">When Data Studio is connecting to the database, the connection status is displayed as follows:</p>
|
|
<p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p43789187"><span><img id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_image58558366" width="171.57000000000002" height="18.9525" src="figure/en-us_image_0000001813599088.png" title="Click to enlarge" class="imgResize"></span></p>
|
|
<p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_p23906515151325">Once the connection is created, all schemas will be displayed in the <strong id="EN-US_TOPIC_0000001813598612__b1952212301113">Object Browser</strong> pane.</p>
|
|
<div class="note" id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_note8954102213520"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_ul5115161012183"><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_li911581001818">You can still log in to Data Studio even if the password has expired, but a message indicating that some operations may not be performed normally will be displayed. For details about how to change the configurations, see <a href="DWS_DS_005.html#EN-US_TOPIC_0000001813438860__table1510418570339">Table 1</a>.</li><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_li10808132825314">PostgreSQL schema names are not displayed in the <strong id="EN-US_TOPIC_0000001813598612__b71340545220">Object Browser</strong> pane.</li></ul>
|
|
</div></div>
|
|
</p></li></ol>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000001813598612__section1925262104113"><h4 class="sectiontitle">Renaming a Connection</h4><ol id="EN-US_TOPIC_0000001813598612__en-us_topic_0185265028_ol11910145123710"><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185265028_li9253185816452"><span>In the <strong id="EN-US_TOPIC_0000001813598612__b175551881035">Object Browser</strong> pane, right-click the selected connection name and select <strong id="EN-US_TOPIC_0000001813598612__b155551581932">Rename Connection</strong>.</span><p><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185265028_p883731154612">A <strong id="EN-US_TOPIC_0000001813598612__b147614161332">Rename Connection</strong> dialog box is displayed, prompting you to enter the new connection name.</p>
|
|
</p></li><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185265028_li117791846132420"><span>Enter the new connection name. Click <strong id="EN-US_TOPIC_0000001813598612__b2544834939">OK</strong> to rename the connection.</span><p><div class="p" id="EN-US_TOPIC_0000001813598612__en-us_topic_0185265028_p175182059122517">The status bar displays the status of the completed operation.<div class="note" id="EN-US_TOPIC_0000001813598612__en-us_topic_0185265028_note591025116376"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185265028_p1926405313451">The new connection name must be unique. Otherwise, the rename operation will fail.</p>
|
|
</div></div>
|
|
</div>
|
|
</p></li></ol>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000001813598612__section1112245924514"><h4 class="sectiontitle">Editing a Connection</h4><ol id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264815_ol977552608"><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264815_li977572104"><span>In the <strong id="EN-US_TOPIC_0000001813598612__b14183391645">Object Browser</strong> pane, right-click the selected connection name and select <strong id="EN-US_TOPIC_0000001813598612__b16183899418">Edit Connection</strong>. The <strong id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264815_b14409845168">Edit Connection</strong> dialog box is displayed.</span><p><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264815_p145951115212">To edit an active connection, you need to disable the connection and then open the connection with the new properties. A warning message about connection resetting is displayed.</p>
|
|
</p></li><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264815_li177618214010"><span>Edit the connection parameters. For details, see <a href="#EN-US_TOPIC_0000001813598612__en-us_topic_0185264624_table109756101700">Table 1</a>.</span><p><div class="note" id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264815_note145415137102"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264815_p854111314104">The database type and name cannot be modified.</p>
|
|
</div></div>
|
|
</p></li><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264815_li57761821906"><span>Click <strong id="EN-US_TOPIC_0000001813598612__b2868575388916">OK</strong>.</span><p><div class="note" id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264815_note14776921509"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264815_ul187771229011"><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264815_li9777162900">You can click <strong id="EN-US_TOPIC_0000001813598612__b6218930368916">Clear</strong> to clear all fields in the <strong id="EN-US_TOPIC_0000001813598612__b10062719818916">Edit Database Connection</strong> dialog box.</li><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264815_li5777425013">If you click <strong id="EN-US_TOPIC_0000001813598612__b9965326508916">OK</strong> without modifying any connection parameters, a dialog box is displayed, indicating that the modification is not saved. After the connection parameters are modified, a dialog box is displayed.</li></ul>
|
|
</div></div>
|
|
</p></li><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264815_li370311443433"><span>If SSL is not enabled, a <strong id="EN-US_TOPIC_0000001813598612__b471145513618">Connection Security Alert</strong> dialog box is displayed. Click <strong id="EN-US_TOPIC_0000001813598612__b37633227717">Continue</strong> to proceed with insecure connections or click <strong id="EN-US_TOPIC_0000001813598612__b15763422071">Cancel</strong> to return to the <strong id="EN-US_TOPIC_0000001813598612__b576322211714">Edit Connection</strong> dialog box to enable SSL.</span><p><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264815_p1945422320453"><strong id="EN-US_TOPIC_0000001813598612__b11777315918916">Do not show again</strong> option is used to hide the <strong id="EN-US_TOPIC_0000001813598612__b1733357268916">Connection Security Alert</strong> dialog box for subsequent connections.</p>
|
|
<p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264815_p131492020454">A dialog box is displayed asking users to confirm whether the database whose connection has been edited is deleted.</p>
|
|
</p></li><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264815_li1177716211016"><span>Click <strong id="EN-US_TOPIC_0000001813598612__b1319341518916">Yes</strong> to proceed to updating the connection information and reconnecting the connection with the updated parameters.</span><p><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264815_p235485812236">The status bar displays the status of the completed operation.</p>
|
|
</p></li></ol>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000001813598612__section9217205365011"><h4 class="sectiontitle">Removing a Connection</h4><ol id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264282_ol14964925"><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264282_li466603"><span>Right-click the selected connection name and select <strong id="EN-US_TOPIC_0000001813598612__b2463135916815">Remove Connection</strong>.</span><p><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264282_p11931101484913">A confirmation dialog box is displayed.</p>
|
|
</p></li><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264282_li41489361"><span>Click <strong id="EN-US_TOPIC_0000001813598612__b185531361992">Yes</strong> to remove the server connection.</span><p><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264282_p1175510155275">The status bar displays the status of the completed operation.</p>
|
|
<p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264282_p18149865">This operation will remove the connection from the <strong id="EN-US_TOPIC_0000001813598612__b36551758994">Object Browser</strong>. Any unsaved data will be lost.</p>
|
|
</p></li></ol>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000001813598612__section6492191155216"><h4 class="sectiontitle">Refreshing Connection Data</h4><ol id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264793_ol7428357123919"><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264793_li16428357103911"><span>In the <strong id="EN-US_TOPIC_0000001813598612__b7745246171018">Object Browser</strong> pane, right-click the selected connection name and select <strong id="EN-US_TOPIC_0000001813598612__b2746346131016">Refresh</strong> or press <strong id="EN-US_TOPIC_0000001813598612__b67461446141018">F5</strong> to update the connection with the latest content on the server.</span><p><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264793_p3921122662714">The status bar displays the status of the completed operation.</p>
|
|
</p></li></ol>
|
|
<ul id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264793_ul37432067"><li id="EN-US_TOPIC_0000001813598612__li1814519310534">The time taken to refresh a database depends on the number of objects in the database. Therefore, you are advised to perform this operation during off-peak hours in a large-scale database.</li><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264793_li8873826162555">If you refresh the entire database or connection, all child objects of schemas in <strong id="EN-US_TOPIC_0000001813598612__b3827143591214">search_path</strong>, as well as the schemas already expanded by the user, will be loaded again.</li><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264793_li37787515162555">If you reconnect to the database, only schema objects saved under <strong id="EN-US_TOPIC_0000001813598612__b2528153141213">search_path</strong> will be loaded. Objects that have been expanded will not be loaded.</li><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264793_li2352745085219">A database and multiple objects under it cannot be refreshed simultaneously.</li></ul>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000001813598612__section1575515305411"><h4 class="sectiontitle">Viewing Connection Properties</h4><ol id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264897_ol616565133415"><li id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264897_li1165355348"><span>Right-click the selected connection and select <strong id="EN-US_TOPIC_0000001813598612__b1271583061316">Properties</strong>.</span><p><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264897_p141217243369">The status bar displays the status of the completed operation.</p>
|
|
<p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264897_p18252102015361">Properties of the selected connection are displayed.</p>
|
|
<div class="note" id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264897_note131170503410"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001813598612__en-us_topic_0185264897_p0165651348">If the property of a created connection is modified, then open the properties of the connection again to view the updated information.</p>
|
|
</div></div>
|
|
</p></li></ol>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_ds_index.html">Data Studio</a></div>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
<script language="JavaScript">
|
|
<!--
|
|
image_size('.imgResize');
|
|
var msg_imageMax = "view original image";
|
|
var msg_imageClose = "close";
|
|
//--></script> |