yexinru/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
Files
a41a4e0331fbc0beff63bb28fa59228cc9a751df
doc-exports/docs/dataartsstudio/umn/dataartsstudio_01_0352.html
chenxiaoxiong f9e2808b7c DataArts UMN 20250810 version 
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Co-authored-by: chenxiaoxiong <chenxiaoxiong@huawei.com>
Co-committed-by: chenxiaoxiong <chenxiaoxiong@huawei.com>
2025-09-02 10:44:13 +00:00

163 lines
31 KiB
HTML
Raw Blame History

<a name="dataartsstudio_01_0352"></a><a name="dataartsstudio_01_0352"></a>
<h1 class="topictitle1">Creating a Connection Between <span id="text7958152062917">DataArts Studio</span> and a GaussDB(DWS) Data Lake</h1>
<div id="body0000001150941616"><p id="dataartsstudio_01_0352__p1742413205233">This section describes how to create a DWS connection between <span id="dataartsstudio_01_0352__text374933943611">DataArts Studio</span> and the data lake base.</p>
<div class="section" id="dataartsstudio_01_0352__section592741692718"><h4 class="sectiontitle">Prerequisites</h4><ul id="dataartsstudio_01_0352__en-us_topic_0000001503129708_en-us_topic_0141836082_ul1460014457815"><li id="dataartsstudio_01_0352__en-us_topic_0000001503129708_en-us_topic_0141836082_li26009457811">You have created a data lake to connect, for example, a database or cloud service supported by <span id="dataartsstudio_01_0352__en-us_topic_0000001503129708_text9577191353117">DataArts Studio</span>.<ul id="dataartsstudio_01_0352__en-us_topic_0000001503129708_ul84381236192412"><li id="dataartsstudio_01_0352__en-us_topic_0000001503129708_li17495193442410">Before creating a DWS data connection, ensure that you have created a cluster in DWS and have the permissions required to view Key Management Service (KMS) keys.</li><li id="dataartsstudio_01_0352__en-us_topic_0000001503129708_li2496193462420">Before creating an MRS connection such as an MRS HBase or MRS Hive connection, ensure that you have created an MRS cluster whose Kerberos encryption type is <strong id="dataartsstudio_01_0352__en-us_topic_0000001503129708_b650474301412">aes256-sha1,aes128-sha1</strong>, and that the cluster contains required components.</li></ul>
</li><li id="dataartsstudio_01_0352__en-us_topic_0000001503129708_li14253123171211">You have obtained the required agent (CDM cluster). If no CDM cluster is available, create one by referring to <a href="dataartsstudio_01_0576.html">Creating a CDM Cluster</a>. The CDM cluster can communicate with the data lake to be connected.<ul id="dataartsstudio_01_0352__en-us_topic_0000001503129708_ul202857182111"><li id="dataartsstudio_01_0352__en-us_topic_0000001503129708_li652416167413">If the data lake is an on-premises database, you need the Internet or Direct Connect. Ensure that the host where the data source is located and the CDM cluster can access the Internet, and the connection port has been enabled in the firewall rule.</li><li id="dataartsstudio_01_0352__en-us_topic_0000001503129708_li1028575215">If the data lake is a cloud service (such as DWS and MRS), the following requirements must be met for network interconnection:<ul id="dataartsstudio_01_0352__en-us_topic_0000001503129708_ul2213578215"><li id="dataartsstudio_01_0352__en-us_topic_0000001503129708_li125579211">If the CDM cluster and the cloud service are in different regions, a public network or a dedicated connection is required for enabling communication between the CDM cluster and the cloud service.</li><li id="dataartsstudio_01_0352__en-us_topic_0000001503129708_li22165792120">If the CDM cluster and the cloud service are in the same region, VPC, subnet, and security group, they can communicate with each other by default. If they are in the same VPC but in different subnets or security groups, you must configure routing rules and security group rules. For details about how to configure routing rules, see "Adding Routes to a Route Table" in <em id="dataartsstudio_01_0352__en-us_topic_0000001503129708_i34445102207">Virtual Private Cloud (VPC) x.x.x User Guide</em> in <em id="dataartsstudio_01_0352__en-us_topic_0000001503129708_i544413106209">Virtual Private Cloud (VPC) x.x.x Usage Guide</em>. For details about how to configure security group rules, see "Security Group" &gt; "Adding a Security Group Rule" in Virtual Private Cloud (VPC) x.x.x User Guide in Virtual Private Cloud (VPC) x.x.x Usage Guide.</li><li id="dataartsstudio_01_0352__en-us_topic_0000001503129708_li428573219">The cloud service instance and the <span id="dataartsstudio_01_0352__en-us_topic_0000001503129708_text92057152114">DataArts Studio</span> workspace belong to the same enterprise project. If they do not, you can modify the enterprise project of the workspace.</li></ul>
</li></ul>
</li><li id="dataartsstudio_01_0352__en-us_topic_0000001503129708_li1563720298461">If the enterprise mode is used, pay attention to the following points:<div class="p" id="dataartsstudio_01_0352__en-us_topic_0000001503129708_p88041040125018"><a name="dataartsstudio_01_0352__en-us_topic_0000001503129708_li1563720298461"></a><a name="en-us_topic_0000001503129708_li1563720298461"></a>In enterprise mode, the development environment and production environment need to be distinguished. Therefore, you need to prepare two sets of data lake services for the production environment and development environment to isolate the development environment from the production environment.<ul id="dataartsstudio_01_0352__en-us_topic_0000001503129708_en-us_topic_0000001232744655_ul1339145017597"><li id="dataartsstudio_01_0352__en-us_topic_0000001503129708_en-us_topic_0000001232744655_li23975014590"><strong id="dataartsstudio_01_0352__en-us_topic_0000001503129708_b1533444714712">If two clusters are used</strong> for clustered data sources, such as MRS, GaussDB(DWS), RDS, MySQL, Oracle, and ECS, you can create data connections in Management Center to distinguish data lake services in the development environment from those in the production environment. The data lake is automatically switched during development and production. Therefore, you need to prepare two sets of data lake services. The versions, specifications, components, regions, VPCs, subnets, and related configurations of the two sets of data lake services must be the same. For details on how to create data connections, see <a href="dataartsstudio_01_1299.html">Creating a DataArts Studio Data Connection</a>.</li><li id="dataartsstudio_01_0352__en-us_topic_0000001503129708_en-us_topic_0000001232744655_li14738135115916">For serverless services (such as DLI), <span id="dataartsstudio_01_0352__en-us_topic_0000001503129708_text8245132816599">DataArts Studio</span> configures the mapping between data lake services in the production environment and development environment through environment isolation in the management center. The corresponding data lake is automatically switched during the development and production processes. Therefore, you need to prepare two sets of queues and database resources in the serverless data lake service and distinguish them by name suffix. For details, see <a href="dataartsstudio_01_5105.html">Configuring Environment Isolation for a DataArts Studio Workspace in Enterprise Mode</a>.</li><li id="dataartsstudio_01_0352__en-us_topic_0000001503129708_li104986432523">For GaussDB(DWS), MRS Hive, and MRS Spark, if you <strong id="dataartsstudio_01_0352__en-us_topic_0000001503129708_b82121932125317">select the same cluster</strong> when creating a data connection, you must configure database mapping on the <strong id="dataartsstudio_01_0352__en-us_topic_0000001503129708_b4212432175319">Configure Data Source Resource Mapping</strong> page to isolate the development and production environments. For details, see <a href="dataartsstudio_01_5105.html#dataartsstudio_01_5105__section20609134272018">DB configuration</a>.</li><li id="dataartsstudio_01_0352__en-us_topic_0000001503129708_li523995419157">Offline processing migration jobs are not supported in enterprise mode.</li></ul>
</div>
<p id="dataartsstudio_01_0352__en-us_topic_0000001503129708_p3637182924612">For example, if your data lake service is an MRS cluster, you need to prepare two MRS clusters with the same version, specifications, components, region, VPC, and subnet. If some configurations of an MRS cluster are modified, you also need to synchronize the modifications to the other MRS cluster.</p>
</li></ul>
</div>
<div class="section" id="dataartsstudio_01_0352__section17688932182719"><h4 class="sectiontitle">Creating a Data Connection</h4><ol id="dataartsstudio_01_0352__ol1278010517247"><li id="dataartsstudio_01_0352__li2848154165110"><span>Log in to the <span id="dataartsstudio_01_0352__en-us_topic_0000001987511677_en-us_topic_0000001127311125_text5574448155719">DataArts Studio</span> console by following the instructions in <a href="dataartsstudio_01_0001.html">Accessing the DataArts Studio Instance Console</a>.</span></li><li class="msonormal" id="dataartsstudio_01_0352__li25881633161913"><span>On the <span id="dataartsstudio_01_0352__en-us_topic_0000001503129708_text82024413513">DataArts Studio</span> console, locate a workspace and click <strong id="dataartsstudio_01_0352__en-us_topic_0000001503129708_b820215416513">Management Center</strong>.</span></li><li id="dataartsstudio_01_0352__li151249491199"><span>On the displayed <strong id="dataartsstudio_01_0352__en-us_topic_0000001503129708_b9193152317519">Manage Data Connections</strong> page, click <strong id="dataartsstudio_01_0352__en-us_topic_0000001503129708_b197049391260">Create Data Connection</strong>.</span><p><div class="fignone" id="dataartsstudio_01_0352__en-us_topic_0000001503129708_fig140165113214"><span class="figcap"><b>Figure 1 </b>Creating a data connection</span><br><span><img id="dataartsstudio_01_0352__en-us_topic_0000001503129708_image62781125125815" src="en-us_image_0000002269195981.png" title="Click to enlarge" class="imgResize"></span></div>
<p id="dataartsstudio_01_0352__en-us_topic_0000001503129708_p5740174641114"></p>
</p></li><li id="dataartsstudio_01_0352__li9780105142416"><span>On the <strong id="dataartsstudio_01_0352__b38231943105318">Manage Data Connections</strong> page, click <span class="uicontrol" id="dataartsstudio_01_0352__uicontrol882714395316"><b>Create Data Connection</b></span>. On the displayed page, select <strong id="dataartsstudio_01_0352__b1482854310535">DWS</strong> for <strong id="dataartsstudio_01_0352__b68281043165318">Data Connection Type</strong> and set other parameters based on the descriptions in <a href="#dataartsstudio_01_0352__table11826143220444">Table 1</a>.</span><p><div class="fignone" id="dataartsstudio_01_0352__fig205261050195010"><span class="figcap"><b>Figure 2 </b>DWS connection parameters</span><br><span><img id="dataartsstudio_01_0352__image47433622519" src="en-us_image_0000002269115869.png" title="Click to enlarge" class="imgResize"></span></div>
<p id="dataartsstudio_01_0352__p13163612252"></p>
<p id="dataartsstudio_01_0352__p12730101432615"></p>
<div class="tablenoborder"><a name="dataartsstudio_01_0352__table11826143220444"></a><a name="table11826143220444"></a><table cellpadding="4" cellspacing="0" summary="" id="dataartsstudio_01_0352__table11826143220444" frame="border" border="1" rules="all"><caption><b>Table 1 </b>DWS connection</caption><thead align="left"><tr id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_row10331275523"><th align="left" class="cellrowborder" valign="top" width="21.5%" id="mcps1.3.3.2.4.2.4.2.4.1.1"><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_p2331227135217">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="9.83%" id="mcps1.3.3.2.4.2.4.2.4.1.2"><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_p033152745213">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="68.67%" id="mcps1.3.3.2.4.2.4.2.4.1.3"><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_p933192785217">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dataartsstudio_01_0352__en-us_topic_0000001554166437_row162181433173"><td class="cellrowborder" valign="top" width="21.5%" headers="mcps1.3.3.2.4.2.4.2.4.1.1 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_p1421933161719">Data Connection Type</p>
</td>
<td class="cellrowborder" valign="top" width="9.83%" headers="mcps1.3.3.2.4.2.4.2.4.1.2 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_p121973121710">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="68.67%" headers="mcps1.3.3.2.4.2.4.2.4.1.3 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_p1721993191719"><strong id="dataartsstudio_01_0352__en-us_topic_0000001554166437_b173661951005">DWS</strong> is selected and cannot be changed.</p>
</td>
</tr>
<tr id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_row73322712520"><td class="cellrowborder" valign="top" width="21.5%" headers="mcps1.3.3.2.4.2.4.2.4.1.1 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_p433112785219">Name</p>
</td>
<td class="cellrowborder" valign="top" width="9.83%" headers="mcps1.3.3.2.4.2.4.2.4.1.2 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_p1833152711522">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="68.67%" headers="mcps1.3.3.2.4.2.4.2.4.1.3 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_p193372775211">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_0352__en-us_topic_0000001554166437_row186884187567"><td class="cellrowborder" valign="top" width="21.5%" headers="mcps1.3.3.2.4.2.4.2.4.1.1 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_p86891718185619">Tag</p>
</td>
<td class="cellrowborder" valign="top" width="9.83%" headers="mcps1.3.3.2.4.2.4.2.4.1.2 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_p817481662715">No</p>
</td>
<td class="cellrowborder" valign="top" width="68.67%" headers="mcps1.3.3.2.4.2.4.2.4.1.3 "><div class="p" id="dataartsstudio_01_0352__en-us_topic_0000001554166437_p11689818105612">Attribute of the data connection to create. Tags make management easier.<div class="note" id="dataartsstudio_01_0352__en-us_topic_0000001554166437_note97121765158"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="dataartsstudio_01_0352__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_0352__en-us_topic_0000001554166437_row622115312358"><td class="cellrowborder" valign="top" width="21.5%" headers="mcps1.3.3.2.4.2.4.2.4.1.1 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_p86981025163112">Applicable Modules</p>
</td>
<td class="cellrowborder" valign="top" width="9.83%" headers="mcps1.3.3.2.4.2.4.2.4.1.2 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_p1969802513312">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="68.67%" headers="mcps1.3.3.2.4.2.4.2.4.1.3 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_p656184715195">Select the modules for which this connection is available.</p>
</td>
</tr>
<tr id="dataartsstudio_01_0352__en-us_topic_0000001554166437_row209004520216"><td class="cellrowborder" colspan="3" valign="top" headers="mcps1.3.3.2.4.2.4.2.4.1.1 mcps1.3.3.2.4.2.4.2.4.1.2 mcps1.3.3.2.4.2.4.2.4.1.3 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_p7900195142117"><strong id="dataartsstudio_01_0352__en-us_topic_0000001554166437_b12144135111618">Basic and Network Connectivity Configuration</strong></p>
</td>
</tr>
<tr id="dataartsstudio_01_0352__en-us_topic_0000001554166437_row566414514420"><td class="cellrowborder" valign="top" width="21.5%" headers="mcps1.3.3.2.4.2.4.2.4.1.1 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_p18048625113">SSL Encryption</p>
</td>
<td class="cellrowborder" valign="top" width="9.83%" headers="mcps1.3.3.2.4.2.4.2.4.1.2 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_p10804961518">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="68.67%" headers="mcps1.3.3.2.4.2.4.2.4.1.3 "><div class="p" id="dataartsstudio_01_0352__en-us_topic_0000001554166437_p5989830192819">DWS supports SSL encryption and certificate authentication for communication between the client and server. You can set this parameter based on whether SSL connection is mandatory on the server.<ul id="dataartsstudio_01_0352__en-us_topic_0000001554166437_ul17736193662815"><li id="dataartsstudio_01_0352__en-us_topic_0000001554166437_li57363365286">If this parameter is enabled, only SSL encryption can be used for communication.</li><li id="dataartsstudio_01_0352__en-us_topic_0000001554166437_li12736133619285">If this parameter is disabled, both SSL encryption and certificate authentication can be used for communication.</li></ul>
</div>
</td>
</tr>
<tr id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_row85665553579"><td class="cellrowborder" valign="top" width="21.5%" headers="mcps1.3.3.2.4.2.4.2.4.1.1 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_p3566205515718">Manual</p>
</td>
<td class="cellrowborder" valign="top" width="9.83%" headers="mcps1.3.3.2.4.2.4.2.4.1.2 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_p5165171611438">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="68.67%" headers="mcps1.3.3.2.4.2.4.2.4.1.3 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_p9487125918229">Select either of the following modes:</p>
<ul id="dataartsstudio_01_0352__en-us_topic_0000001554166437_ul397819617341"><li id="dataartsstudio_01_0352__en-us_topic_0000001554166437_li18978126143417"><strong id="dataartsstudio_01_0352__en-us_topic_0000001554166437_b1154911471479">Cluster Name Mode</strong>: Select an existing cluster.</li><li id="dataartsstudio_01_0352__en-us_topic_0000001554166437_li103889143412"><strong id="dataartsstudio_01_0352__en-us_topic_0000001554166437_b118931426184">Connection String Mode</strong>: Enter the IP address/domain name and port of the corresponding cluster and enable the communication between the connection's agent (CDM cluster) and the DWS cluster.</li></ul>
<div class="note" id="dataartsstudio_01_0352__en-us_topic_0000001554166437_note92381234131210"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_p1750654017127">DataArts Security does not support GaussDB(DWS) connections in connection string mode.</p>
</div></div>
</td>
</tr>
<tr id="dataartsstudio_01_0352__en-us_topic_0000001554166437_row84236242259"><td class="cellrowborder" valign="top" width="21.5%" headers="mcps1.3.3.2.4.2.4.2.4.1.1 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_p1533182795213">DWS Cluster Name</p>
</td>
<td class="cellrowborder" valign="top" width="9.83%" headers="mcps1.3.3.2.4.2.4.2.4.1.2 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_p251124424219">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="68.67%" headers="mcps1.3.3.2.4.2.4.2.4.1.3 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_p11325152132619">This parameter is mandatory when <strong id="dataartsstudio_01_0352__en-us_topic_0000001554166437_b5568204591210">Manual</strong> is set to <strong id="dataartsstudio_01_0352__en-us_topic_0000001554166437_b115565221315">Cluster Name Mode</strong>.</p>
<p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_p1733172715214">Select a DWS cluster from all the DWS clusters with the same project ID and enterprise project.</p>
</td>
</tr>
<tr id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_row1223798105810"><td class="cellrowborder" valign="top" width="21.5%" headers="mcps1.3.3.2.4.2.4.2.4.1.1 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_p1723710805818">IP Address or Domain Name</p>
</td>
<td class="cellrowborder" valign="top" width="9.83%" headers="mcps1.3.3.2.4.2.4.2.4.1.2 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_p0701746144311">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="68.67%" headers="mcps1.3.3.2.4.2.4.2.4.1.3 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_p1928873613262">This parameter is mandatory when <strong id="dataartsstudio_01_0352__en-us_topic_0000001554166437_b13782224101412">Manual</strong> is set to <strong id="dataartsstudio_01_0352__en-us_topic_0000001554166437_b27820241144">Connection String Mode</strong>.</p>
<p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_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>
<div class="p" id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_p341418228813">This parameter indicates the address for accessing the cluster database through an internal network. Enter an IP address or domain name. The IP address or domain name is automatically generated during cluster creation. You can obtain them on the management console by performing the following operations:<ol type="a" id="dataartsstudio_01_0352__en-us_topic_0000001554166437_ol1938014919172"><li id="dataartsstudio_01_0352__en-us_topic_0000001554166437_li438020493175">Log in to the GaussDB(DWS) console.</li><li id="dataartsstudio_01_0352__en-us_topic_0000001554166437_li33808497178">In the left navigation pane, choose <strong id="dataartsstudio_01_0352__en-us_topic_0000001554166437_b60484171551448">Instances</strong>.</li><li id="dataartsstudio_01_0352__en-us_topic_0000001554166437_li18380164931718">Click the name of an instance to enter the basic information page. In the <strong id="dataartsstudio_01_0352__en-us_topic_0000001554166437_b93042978451448">Connection Information</strong> area, you can obtain the private IP address, domain name, and port number.</li></ol>
</div>
</td>
</tr>
<tr id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_row370619114587"><td class="cellrowborder" valign="top" width="21.5%" headers="mcps1.3.3.2.4.2.4.2.4.1.1 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_p1470610114587">Port</p>
</td>
<td class="cellrowborder" valign="top" width="9.83%" headers="mcps1.3.3.2.4.2.4.2.4.1.2 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_p11354164814314">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="68.67%" headers="mcps1.3.3.2.4.2.4.2.4.1.3 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_p15977807276">This parameter is mandatory when <strong id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0000001554166437_b13782224101412">Manual</strong> is set to <strong id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0000001554166437_b27820241144">Connection String Mode</strong>.</p>
<p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_p1091220122920">This parameter indicates the database port number specified during the DWS cluster creation. Ensure that you have enabled this port in the security group rule so that the <span id="dataartsstudio_01_0352__en-us_topic_0000001554166437_text6666183819586">DataArts Studio</span> instance can connect to the database in the DWS cluster through this port.</p>
</td>
</tr>
<tr id="dataartsstudio_01_0352__en-us_topic_0000001554166437_row432965673513"><td class="cellrowborder" valign="top" width="21.5%" headers="mcps1.3.3.2.4.2.4.2.4.1.1 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_p43320271527">KMS Key</p>
</td>
<td class="cellrowborder" valign="top" width="9.83%" headers="mcps1.3.3.2.4.2.4.2.4.1.2 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_p1833162715212">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="68.67%" headers="mcps1.3.3.2.4.2.4.2.4.1.3 "><div class="p" id="dataartsstudio_01_0352__en-us_topic_0000001554166437_p417915433339">KMS key used to encrypt and decrypt data source authentication information. Select a default or custom key.<div class="note" id="dataartsstudio_01_0352__en-us_topic_0000001554166437_note5782131311013"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="dataartsstudio_01_0352__en-us_topic_0000001554166437_ul15258512511"><li id="dataartsstudio_01_0352__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_0352__en-us_topic_0000001554166437_b10282246320">dlf/default</strong> or <strong id="dataartsstudio_01_0352__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_0352__en-us_topic_0000001554166437_i155895285215">Data Encryption Workshop FAQs</em>.</li><li id="dataartsstudio_01_0352__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_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_row733122725220"><td class="cellrowborder" valign="top" width="21.5%" headers="mcps1.3.3.2.4.2.4.2.4.1.1 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_p143319273527">Agent</p>
</td>
<td class="cellrowborder" valign="top" width="9.83%" headers="mcps1.3.3.2.4.2.4.2.4.1.2 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_p533132716529">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="68.67%" headers="mcps1.3.3.2.4.2.4.2.4.1.3 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_p8767229585">Data Warehouse Service (DWS) is not a fully managed service and thus cannot be directly connected to <span id="dataartsstudio_01_0352__en-us_topic_0000001554166437_text2076722145814">DataArts Studio</span>. A CDM cluster can provide an agent for <span id="dataartsstudio_01_0352__en-us_topic_0000001554166437_text18764228587">DataArts Studio</span> to communicate with non-fully-managed services. Therefore, you need to select a CDM cluster when creating a DWS 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_0352__en-us_topic_0000001554166437_p18707105615111">As a network proxy, the CDM cluster must be able to communicate with the DWS cluster. To ensure network connectivity, the CDM cluster must be in the same region and AZ and use the same VPC and subnet as the DWS cluster. The security group rule must also allow the CDM cluster communicate with the DWS cluster.</p>
<div class="note" id="dataartsstudio_01_0352__en-us_topic_0000001554166437_note188764120291"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="dataartsstudio_01_0352__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_0352__en-us_topic_0000001554166437_row1163634617291"><td class="cellrowborder" colspan="3" valign="top" headers="mcps1.3.3.2.4.2.4.2.4.1.1 mcps1.3.3.2.4.2.4.2.4.1.2 mcps1.3.3.2.4.2.4.2.4.1.3 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_p12895195118290"><strong id="dataartsstudio_01_0352__en-us_topic_0000001554166437_b17178638142211">Data Source Authentication and Other Function Configuration</strong></p>
</td>
</tr>
<tr id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_row033327105212"><td class="cellrowborder" valign="top" width="21.5%" headers="mcps1.3.3.2.4.2.4.2.4.1.1 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_p1331327155219">Username</p>
</td>
<td class="cellrowborder" valign="top" width="9.83%" headers="mcps1.3.3.2.4.2.4.2.4.1.2 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_p23315274525">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="68.67%" headers="mcps1.3.3.2.4.2.4.2.4.1.3 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_p724175732315">The database username, which is specified when the DWS cluster is created.</p>
</td>
</tr>
<tr id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_row1833627155213"><td class="cellrowborder" valign="top" width="21.5%" headers="mcps1.3.3.2.4.2.4.2.4.1.1 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_p1333162775210">Password</p>
</td>
<td class="cellrowborder" valign="top" width="9.83%" headers="mcps1.3.3.2.4.2.4.2.4.1.2 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_p193318279521">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="68.67%" headers="mcps1.3.3.2.4.2.4.2.4.1.3 "><p id="dataartsstudio_01_0352__en-us_topic_0000001554166437_en-us_topic_0141836082_p123581838125016">The password for accessing the database, which is specified when the DWS cluster is created.</p>
</td>
</tr>
</tbody>
</table>
</div>
</p></li><li id="dataartsstudio_01_0352__li57807515243"><span>Click <strong id="dataartsstudio_01_0352__b1321614711210">Test</strong> to test connectivity of the data connection. If the test fails, the data connection fails to be created.</span></li><li id="dataartsstudio_01_0352__li1078185132416"><span>After the test is successful, click <strong id="dataartsstudio_01_0352__b102694247141">Save</strong> to create the data connection.</span></li></ol>
</div>
<div class="section" id="dataartsstudio_01_0352__section1114732851415"><h4 class="sectiontitle">Reference</h4><ol id="dataartsstudio_01_0352__ol43131936141412"><li id="dataartsstudio_01_0352__li15814650111417">What should I do if the connection test fails when I enable the SSL connection during the creation of a DWS data connection?<div class="p" id="dataartsstudio_01_0352__p0687304160"><a name="dataartsstudio_01_0352__li15814650111417"></a><a name="li15814650111417"></a>On the DWS console, click the corresponding cluster, choose <strong id="dataartsstudio_01_0352__en-us_topic_0000001071958176_b8855616425">Security Settings</strong>, and disable <strong id="dataartsstudio_01_0352__en-us_topic_0000001071958176_b128551511422">Rights Separation</strong>.<div class="fignone" id="dataartsstudio_01_0352__en-us_topic_0000001071958176_fig173541771611"><span class="figcap"><b>Figure 3 </b>Disabling Rights Separation for the DWS cluster</span><br><span><img id="dataartsstudio_01_0352__en-us_topic_0000001071958176_image169722611522" src="en-us_image_0000002269195969.png" title="Click to enlarge" class="imgResize"></span></div>
</div>
</li><li id="dataartsstudio_01_0352__li33135368147">Why does a DWS data connection fail to obtain information about databases or tables?<p id="dataartsstudio_01_0352__p11632155513148"><a name="dataartsstudio_01_0352__li33135368147"></a><a name="li33135368147"></a>The possible cause is that the CDM cluster is stopped or a concurrency conflict occurs. You can switch to another agent to temporarily avoid this issue.</p>
</li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dataartsstudio_01_0350.html">Typical Scenarios for Using Management Center</a></div>
</div>
</div>
<script language="JavaScript">
<!--
initImageViewer('.imgResize');
var msg_imageMax = "view original image";
var msg_imageClose = "close";
//--></script>
View Git Blame Copy Permalink