Help Center> DataArts Studio> User Guide> Management Center> Managing Data Connections> Configuring an RDS Connection
Updated on 2024-04-03 GMT+08:00
View PDF

Configuring an RDS Connection

You can create connections to RDS databases including MySQL, PostgreSQL, SQL Server, SAP HANA, and DM databases.

Table 1 RDS connection

Parameter

Mandatory

Description

Data Connection Type

Yes

RDS is selected by default and cannot be changed.

Name

Yes

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 (-).

Tag

No
Attribute of the data connection to create. Tags make management easier.
NOTE:

The tag name can contain only letters, digits, and underscores (_) and cannot start with an underscore (_) or contain more than 100 characters.

Applicable Modules

Yes

Select the modules for which this connection is available.

All modules are selected by default, which means this connection is available for all the modules that support the data source connected by this connection. For details about the data sources supported by each module, see Data Sources.

Basic and Network Connectivity Configuration

IP Address or Domain Name

Yes

Address for accessing the relational database data source. The value can be an IP address or a domain name.

  • If the data source is RDS or GaussDB, you can obtain the address on the management console by performing the following operations:
    1. Log in to the management console of the corresponding cloud service using the account you have obtained.
    2. In the left navigation pane, choose Instances.
    3. Click the name of an instance to enter the basic information page. In the Connection Information area, you can obtain the private IP address, domain name, and port number.
    NOTE:

    Only the GaussDB data source supports multiple domain names. Use commas (,) to separate multiple domain names.

  • If the data source is MySQL, PostgreSQL, or DM, you can obtain the access address from the database administrator.

Port

Yes

Port for accessing the relational database.

  • If the data source is RDS or GaussDB, you can obtain the address on the management console by performing the following operations:
    1. Log in to the management console of the corresponding cloud service using the account you have obtained.
    2. In the left navigation pane, choose Instances.
    3. Click the name of an instance to enter the basic information page. In the Connection Information area, you can obtain the private IP address, domain name, and port number.
    NOTE:

    Only the GaussDB data source supports multiple domain names. Use commas (,) to separate multiple domain names.

  • If the data source is MySQL, PostgreSQL, or DM, you can obtain the access address from the database administrator.

KMS Key

Yes

KMS key used to encrypt and decrypt the authentication information for the data source

Agent

Yes

RDS is not a fully managed service and cannot be directly connected to DataArts Studio. A CDM cluster can provide an agent for DataArts Studio 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.

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, AZ, VPC, and subnet as RDS. The security group rule must also allow the CDM cluster to communicate with RDS.

NOTE:

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.

Data Source Driver Configuration

Driver Name

Yes

The name of the driver. The following values are available:

  • com.mysql.jdbc.Driver: Select this driver name for RDS for MySQL or MySQL.
  • org.postgresql.Driver: Select this driver name for RDS for PostgreSQL or PostgreSQL.
  • com.microsoft.sqlserver.jdbc.SQLServerDriver: Select this driver name for RDS for SQL Server.
  • dm.jdbc.driver.DmDriver: Select this driver name for the Dameng database.
  • com.huawei.opengauss.jdbc.Driver: Select this driver name for RDS for GaussDB.

Driver File Path

Yes

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.

NOTE:
  • The OBS path of the driver file cannot contain Chinese characters.
  • To update the driver, you must restart the CDM cluster in DataArts Migration and then edit the data connection to upload the driver.

Data Source Authentication and Other Function Configuration

Username

Yes

The username of the database. The username is required for creating a cluster.

Password

Yes

The password for accessing the database. The password is required for creating a cluster.