forked from docs/doc-exports
chenxiaoxiong
f9e2808b7c
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com> Co-authored-by: chenxiaoxiong <chenxiaoxiong@huawei.com> Co-committed-by: chenxiaoxiong <chenxiaoxiong@huawei.com>
155 lines
20 KiB
HTML
155 lines
20 KiB
HTML
<a name="dataartsstudio_01_1303"></a><a name="dataartsstudio_01_1303"></a>
|
|
|
|
<h1 class="topictitle1">RDS Connection Parameters</h1>
|
|
<div id="body0000001503126756"><p id="dataartsstudio_01_1303__p1450533682">RDS connections can be used to connect to MySQL, PostgreSQL, and SQL Server databases.</p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dataartsstudio_01_1303__en-us_topic_0141836082_table126135615295" frame="border" border="1" rules="all"><caption><b>Table 1 </b>RDS connection</caption><thead align="left"><tr id="dataartsstudio_01_1303__en-us_topic_0141836082_row14785613295"><th align="left" class="cellrowborder" valign="top" width="21.18%" id="mcps1.3.2.2.4.1.1"><p id="dataartsstudio_01_1303__en-us_topic_0141836082_p77135618295">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="9.47%" id="mcps1.3.2.2.4.1.2"><p id="dataartsstudio_01_1303__en-us_topic_0141836082_p6712562296">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="69.35%" id="mcps1.3.2.2.4.1.3"><p id="dataartsstudio_01_1303__en-us_topic_0141836082_p117756132916">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dataartsstudio_01_1303__row2454155344917"><td class="cellrowborder" valign="top" width="21.18%" headers="mcps1.3.2.2.4.1.1 "><p id="dataartsstudio_01_1303__p187882052124512">Data Connection Type</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9.47%" headers="mcps1.3.2.2.4.1.2 "><p id="dataartsstudio_01_1303__p4788145294511">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.35%" headers="mcps1.3.2.2.4.1.3 "><p id="dataartsstudio_01_1303__p5788165212458"><strong id="dataartsstudio_01_1303__b167671615102710">RDS</strong> is selected by default and cannot be changed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dataartsstudio_01_1303__en-us_topic_0141836082_row14755612299"><td class="cellrowborder" valign="top" width="21.18%" headers="mcps1.3.2.2.4.1.1 "><p id="dataartsstudio_01_1303__en-us_topic_0141836082_p97135682918">Name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9.47%" headers="mcps1.3.2.2.4.1.2 "><p id="dataartsstudio_01_1303__en-us_topic_0141836082_p10815619295">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.35%" headers="mcps1.3.2.2.4.1.3 "><p id="dataartsstudio_01_1303__p10487624232">Name of the data connection to create. Data connection names can contain a maximum of 100 characters. They can contain only letters, digits, underscores (_), and hyphens (-).</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dataartsstudio_01_1303__row16372172795310"><td class="cellrowborder" valign="top" width="21.18%" headers="mcps1.3.2.2.4.1.1 "><p id="dataartsstudio_01_1303__p13373172711538">Tag</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9.47%" headers="mcps1.3.2.2.4.1.2 "><p id="dataartsstudio_01_1303__p237472715316">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.35%" headers="mcps1.3.2.2.4.1.3 "><div class="p" id="dataartsstudio_01_1303__p194874211237">Attribute of the data connection to create. Tags make management easier.<div class="note" id="dataartsstudio_01_1303__en-us_topic_0000001554166437_note97121765158"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="dataartsstudio_01_1303__en-us_topic_0000001554166437_p107124612153">The tag name can contain only letters, digits, and underscores (_) and cannot start with an underscore (_) or contain more than 100 characters.</p>
|
|
</div></div>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="dataartsstudio_01_1303__row744911384502"><td class="cellrowborder" valign="top" width="21.18%" headers="mcps1.3.2.2.4.1.1 "><p id="dataartsstudio_01_1303__p1313102611386">Applicable Modules</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9.47%" headers="mcps1.3.2.2.4.1.2 "><p id="dataartsstudio_01_1303__p1013192653810">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.35%" headers="mcps1.3.2.2.4.1.3 "><p id="dataartsstudio_01_1303__p1313192653818">Select the modules for which this connection is available.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dataartsstudio_01_1303__row95141947125014"><td class="cellrowborder" colspan="3" valign="top" headers="mcps1.3.2.2.4.1.1 mcps1.3.2.2.4.1.2 mcps1.3.2.2.4.1.3 "><p id="dataartsstudio_01_1303__p85151347175011"><strong id="dataartsstudio_01_1303__b18575125754656">Basic and Network Connectivity Configuration</strong></p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dataartsstudio_01_1303__en-us_topic_0141836082_row26676209301"><td class="cellrowborder" valign="top" width="21.18%" headers="mcps1.3.2.2.4.1.1 "><p id="dataartsstudio_01_1303__en-us_topic_0141836082_p17667152013013">IP Address or Domain Name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9.47%" headers="mcps1.3.2.2.4.1.2 "><p id="dataartsstudio_01_1303__en-us_topic_0141836082_p366762043017">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.35%" headers="mcps1.3.2.2.4.1.3 "><p id="dataartsstudio_01_1303__p8652120113412">Address for accessing the relational database data source. The value can be an IP address or a domain name.</p>
|
|
<p id="dataartsstudio_01_1303__en-us_topic_0141836082_p184519401478">If you choose to manually enter an IP address or domain name, you must enter an internal IP address and a port that is accessible to the network segment of the resource group. Otherwise, the network is disconnected.</p>
|
|
<ul id="dataartsstudio_01_1303__ul6534191764719"><li id="dataartsstudio_01_1303__li95351617144719">If the data source is RDS, you can obtain the address on the management console by performing the following operations:<ol id="dataartsstudio_01_1303__en-us_topic_0141836082_ol126164591245"><li id="dataartsstudio_01_1303__en-us_topic_0141836082_li156165591943">Log in to the management console of the corresponding cloud service using the account you have obtained.</li><li id="dataartsstudio_01_1303__en-us_topic_0141836082_li0617191856">In the left navigation pane, choose <strong id="dataartsstudio_01_1303__b193074964151649">Instances</strong>.</li><li id="dataartsstudio_01_1303__en-us_topic_0141836082_li281448517">Click the name of an instance to enter the basic information page. In the <strong id="dataartsstudio_01_1303__b75315699051649">Connection Information</strong> area, you can obtain the private IP address, domain name, and port number.</li></ol>
|
|
</li><li id="dataartsstudio_01_1303__li17221143914713">If the data source is MySQL, PostgreSQL, or DM, you can obtain the access address from the database administrator.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="dataartsstudio_01_1303__en-us_topic_0141836082_row1550872653018"><td class="cellrowborder" valign="top" width="21.18%" headers="mcps1.3.2.2.4.1.1 "><p id="dataartsstudio_01_1303__en-us_topic_0141836082_p6509926153010">Port</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9.47%" headers="mcps1.3.2.2.4.1.2 "><p id="dataartsstudio_01_1303__en-us_topic_0141836082_p175097264306">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.35%" headers="mcps1.3.2.2.4.1.3 "><p id="dataartsstudio_01_1303__en-us_topic_0141836082_p067145020470">Port for accessing the relational database.</p>
|
|
<ul id="dataartsstudio_01_1303__ul1224210217529"><li id="dataartsstudio_01_1303__en-us_topic_0000001503126756_li95351617144719">If the data source is RDS, you can obtain the address on the management console by performing the following operations:<ol id="dataartsstudio_01_1303__en-us_topic_0000001503126756_en-us_topic_0141836082_ol126164591245"><li id="dataartsstudio_01_1303__en-us_topic_0000001503126756_en-us_topic_0141836082_li156165591943">Log in to the management console of the corresponding cloud service using the account you have obtained.</li><li id="dataartsstudio_01_1303__en-us_topic_0000001503126756_en-us_topic_0141836082_li0617191856">In the left navigation pane, choose <strong id="dataartsstudio_01_1303__en-us_topic_0000001503126756_b193074964151649">Instances</strong>.</li><li id="dataartsstudio_01_1303__en-us_topic_0000001503126756_en-us_topic_0141836082_li281448517">Click the name of an instance to enter the basic information page. In the <strong id="dataartsstudio_01_1303__en-us_topic_0000001503126756_b75315699051649">Connection Information</strong> area, you can obtain the private IP address, domain name, and port number.</li></ol>
|
|
</li><li id="dataartsstudio_01_1303__en-us_topic_0000001503126756_li17221143914713">If the data source is MySQL, PostgreSQL, or DM, you can obtain the access address from the database administrator.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="dataartsstudio_01_1303__row17791822124616"><td class="cellrowborder" valign="top" width="21.18%" headers="mcps1.3.2.2.4.1.1 "><p id="dataartsstudio_01_1303__p20791122134614">Cluster Mode</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9.47%" headers="mcps1.3.2.2.4.1.2 "><p id="dataartsstudio_01_1303__p27921922164616">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.35%" headers="mcps1.3.2.2.4.1.3 "><p id="dataartsstudio_01_1303__p13645318121515">GaussDB cluster mode. This parameter is available when <strong id="dataartsstudio_01_1303__b1717632717411">Driver Name</strong> is set to <strong id="dataartsstudio_01_1303__b199141438242">com.huawei.opengauss.jdbc.Driver</strong>.</p>
|
|
<ul id="dataartsstudio_01_1303__ul17500056184619"><li id="dataartsstudio_01_1303__li1500175644619">Primary/Standby</li><li id="dataartsstudio_01_1303__li5500185612467">Distributed</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="dataartsstudio_01_1303__row338251917319"><td class="cellrowborder" valign="top" width="21.18%" headers="mcps1.3.2.2.4.1.1 "><p id="dataartsstudio_01_1303__en-us_topic_0141836082_p8895642919">KMS Key</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9.47%" headers="mcps1.3.2.2.4.1.2 "><p id="dataartsstudio_01_1303__en-us_topic_0141836082_p188456152916">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.35%" headers="mcps1.3.2.2.4.1.3 "><div class="p" id="dataartsstudio_01_1303__p4476133012514">KMS key used to encrypt and decrypt data source authentication information. Select a default or custom key.<div class="note" id="dataartsstudio_01_1303__en-us_topic_0000001554166437_note5782131311013"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="dataartsstudio_01_1303__en-us_topic_0000001554166437_ul15258512511"><li id="dataartsstudio_01_1303__en-us_topic_0000001554166437_li652514518257">When you use KMS for encryption through DataArts Studio or KPS for the first time, the default key <strong id="dataartsstudio_01_1303__en-us_topic_0000001554166437_b10282246320">dlf/default</strong> or <strong id="dataartsstudio_01_1303__en-us_topic_0000001554166437_b7601112203216">kps/default</strong> is automatically generated. For more information about default keys, see "What Is a Default Master Key?" in <em id="dataartsstudio_01_1303__en-us_topic_0000001554166437_i155895285215">Data Encryption Workshop FAQs</em>.</li><li id="dataartsstudio_01_1303__en-us_topic_0000001554166437_li694815818253">Only symmetric keys are supported. Asymmetric keys are not supported.</li></ul>
|
|
</div></div>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="dataartsstudio_01_1303__row128782915522"><td class="cellrowborder" valign="top" width="21.18%" headers="mcps1.3.2.2.4.1.1 "><p id="dataartsstudio_01_1303__en-us_topic_0141836082_p2995612299">Agent</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9.47%" headers="mcps1.3.2.2.4.1.2 "><p id="dataartsstudio_01_1303__en-us_topic_0141836082_p7919567292">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.35%" headers="mcps1.3.2.2.4.1.3 "><p id="dataartsstudio_01_1303__en-us_topic_0141836082_p4985642920">RDS is not a fully managed service and cannot be directly connected to <span id="dataartsstudio_01_1303__text178131223207">DataArts Studio</span>. A CDM cluster can provide an agent for <span id="dataartsstudio_01_1303__text560102916011">DataArts Studio</span> to communicate with non-fully-managed services. Therefore, you need to select a CDM cluster when creating an RDS data connection. If no CDM cluster is available, create one first by referring to <a href="dataartsstudio_01_0576.html">Creating a CDM Cluster</a>.</p>
|
|
<p id="dataartsstudio_01_1303__p56909105619">As a network proxy, the CDM cluster must be able to communicate with RDS. To ensure network connectivity, the CDM cluster must be in the same region and AZ and use the same VPC and subnet as RDS. The security group rule must also allow the CDM cluster to communicate with RDS.</p>
|
|
<div class="note" id="dataartsstudio_01_1303__note183952159481"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="dataartsstudio_01_1303__en-us_topic_0000001554166437_p28781712162910">If a CDM cluster functions as the agent for a data connection in Management Center, the cluster supports a maximum of 200 concurrent active threads. If multiple data connections share an agent, a maximum of 200 SQL, Shell, and Python scripts submitted through the connections can run concurrently. Excess tasks will be queued. You are advised to plan multiple agents based on the workload.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="dataartsstudio_01_1303__row180232492218"><td class="cellrowborder" valign="top" width="21.18%" headers="mcps1.3.2.2.4.1.1 "><p id="dataartsstudio_01_1303__p2803192410228">SSL Encryption</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9.47%" headers="mcps1.3.2.2.4.1.2 "><p id="dataartsstudio_01_1303__p68031224172213">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.35%" headers="mcps1.3.2.2.4.1.3 "><p id="dataartsstudio_01_1303__p16803202414224">Whether to enable SSL encrypted transmission.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dataartsstudio_01_1303__row1137112265526"><td class="cellrowborder" colspan="3" valign="top" headers="mcps1.3.2.2.4.1.1 mcps1.3.2.2.4.1.2 mcps1.3.2.2.4.1.3 "><p id="dataartsstudio_01_1303__p1461713985116"><strong id="dataartsstudio_01_1303__b11259131517309">Data Source Driver Configuration</strong></p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dataartsstudio_01_1303__row189541350535"><td class="cellrowborder" valign="top" width="21.18%" headers="mcps1.3.2.2.4.1.1 "><p id="dataartsstudio_01_1303__p16999144010551">Driver Name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9.47%" headers="mcps1.3.2.2.4.1.2 "><p id="dataartsstudio_01_1303__p199997408559">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.35%" headers="mcps1.3.2.2.4.1.3 "><p id="dataartsstudio_01_1303__p29995405551">The name of the driver. The following values are available:</p>
|
|
<ul id="dataartsstudio_01_1303__ul17999194025510"><li id="dataartsstudio_01_1303__li2074195514"><strong id="dataartsstudio_01_1303__b141098745451649">com.mysql.jdbc.Driver</strong>: Select this driver name for RDS for MySQL or MySQL.</li><li id="dataartsstudio_01_1303__li1707411557"><strong id="dataartsstudio_01_1303__b150071622051649">org.postgresql.Driver</strong>: Select this driver name for RDS for PostgreSQL or PostgreSQL.</li><li id="dataartsstudio_01_1303__li69751810202320"><strong id="dataartsstudio_01_1303__b1785173018417">com.microsoft.sqlserver.jdbc.SQLServerDriver</strong>: Select this driver name for RDS for SQL Server.</li><li id="dataartsstudio_01_1303__li12024185517"><strong id="dataartsstudio_01_1303__b43679056951649">com.huawei.opengauss.jdbc.Driver</strong>: Select this driver name for RDS for GaussDB.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="dataartsstudio_01_1303__row7897113195312"><td class="cellrowborder" valign="top" width="21.18%" headers="mcps1.3.2.2.4.1.1 "><p id="dataartsstudio_01_1303__p2321529114416">Driver file source</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9.47%" headers="mcps1.3.2.2.4.1.2 "><p id="dataartsstudio_01_1303__p2321102924411">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.35%" headers="mcps1.3.2.2.4.1.3 "><p id="dataartsstudio_01_1303__p2321142924415">Select the source of the driver file.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dataartsstudio_01_1303__row178801533125311"><td class="cellrowborder" valign="top" width="21.18%" headers="mcps1.3.2.2.4.1.1 "><p id="dataartsstudio_01_1303__p1503183113583">Driver File Path</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9.47%" headers="mcps1.3.2.2.4.1.2 "><p id="dataartsstudio_01_1303__p95039312585">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.35%" headers="mcps1.3.2.2.4.1.3 "><p id="dataartsstudio_01_1303__p20503163155811">It specifies the OBS path where the driver file is located. You need to download a .jar driver file from the corresponding official website and upload it to OBS.</p>
|
|
<ul id="dataartsstudio_01_1303__ul12503103115586"><li id="dataartsstudio_01_1303__li1850353113583">MySQL driver: Download it from <a href="https://downloads.mysql.com/archives/c-j/" target="_blank" rel="noopener noreferrer">https://downloads.mysql.com/archives/c-j/</a>. The 5.1.48 version is recommended.</li><li id="dataartsstudio_01_1303__li13171562015">PostgreSQL driver: Download it from <a href="https://mvnrepository.com/artifact/org.postgresql/postgresql" target="_blank" rel="noopener noreferrer">https://mvnrepository.com/artifact/org.postgresql/postgresql</a>. The 42.3.4 version is recommended.</li><li id="dataartsstudio_01_1303__li194817561645">SQL Server driver: Download it from <a href="https://learn.microsoft.com/en-us/sql/connect/jdbc/download-microsoft-jdbc-driver-for-sql-server?view=sql-server-ver16" target="_blank" rel="noopener noreferrer">https://learn.microsoft.com/en-us/sql/connect/jdbc/download-microsoft-jdbc-driver-for-sql-server?view=sql-server-ver16</a>. The 8.4.1 version is recommended.</li><li id="dataartsstudio_01_1303__li145047310582">GaussDB driver: Search for "JDBC Package, Driver Class, and Environment Class" in <em id="dataartsstudio_01_1303__i17818191284810">GaussDB User Guide</em>, select the document corresponding to the instance version, and obtain the driver package by referring to the document. </li></ul>
|
|
<div class="note" id="dataartsstudio_01_1303__note20506131135818"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="dataartsstudio_01_1303__ul13133132082310"><li id="dataartsstudio_01_1303__li13134132042314">The OBS path of the driver file cannot contain Chinese characters.</li><li id="dataartsstudio_01_1303__li141341320182316">To update the driver, you must restart the CDM cluster in DataArts Migration and then edit the data connection to upload the driver.</li></ul>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="dataartsstudio_01_1303__row1036682385215"><td class="cellrowborder" colspan="3" valign="top" headers="mcps1.3.2.2.4.1.1 mcps1.3.2.2.4.1.2 mcps1.3.2.2.4.1.3 "><p id="dataartsstudio_01_1303__p17627137195815"><strong id="dataartsstudio_01_1303__b206448639542243">Data Source Authentication and Other Function Configuration</strong></p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dataartsstudio_01_1303__en-us_topic_0141836082_row78155622914"><td class="cellrowborder" valign="top" width="21.18%" headers="mcps1.3.2.2.4.1.1 "><p id="dataartsstudio_01_1303__en-us_topic_0141836082_p1684561296">Username</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9.47%" headers="mcps1.3.2.2.4.1.2 "><p id="dataartsstudio_01_1303__en-us_topic_0141836082_p1781756152915">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.35%" headers="mcps1.3.2.2.4.1.3 "><p id="dataartsstudio_01_1303__en-us_topic_0141836082_p447915434228">The username of the database. The username is required for creating a cluster.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dataartsstudio_01_1303__en-us_topic_0141836082_row98155617296"><td class="cellrowborder" valign="top" width="21.18%" headers="mcps1.3.2.2.4.1.1 "><p id="dataartsstudio_01_1303__en-us_topic_0141836082_p9815614295">Password</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9.47%" headers="mcps1.3.2.2.4.1.2 "><p id="dataartsstudio_01_1303__en-us_topic_0141836082_p889561290">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.35%" headers="mcps1.3.2.2.4.1.3 "><p id="dataartsstudio_01_1303__en-us_topic_0141836082_p184791343132210">The password for accessing the database. The password is required for creating a cluster.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="dataartsstudio_01_0009.html">Configuring DataArts Studio Data Connection Parameters</a></div>
|
|
</div>
|
|
</div>
|
|
|