Help Center/ Relational Database Service/ Getting Started/ Getting Started with RDS for MariaDB/ Step 2: Connect to a DB Instance/ Connecting to a DB Instance Through a Private Network/ Connecting to a DB Instance Using a MariaDB Client
Updated on 2023-12-28 GMT+08:00
View PDF

Connecting to a DB Instance Using a MariaDB Client

You can connect to a DB instance through a Secure Sockets Layer (SSL) connection or a non-SSL connection. SSL encrypts connections to your DB instance, making in-transit data more secure.

Prerequisites

  1. You have logged in to an ECS.
    • To connect to a DB instance through an ECS, you must ensure that:
      • The ECS and DB instance are in the same VPC.
      • The ECS is allowed by the security group to access the DB instance.
        • If the security group associated with the DB instance is the default security group, you do not need to configure security group rules.
        • If the security group associated with the DB instance is not the default security group, check whether the security group rules allow the ECS to connect to the DB instance. For details, see Configuring Security Group Rules.

          If the rules allow the access from the ECS, you can connect to the DB instance through the ECS.

          If the rules do not allow the access from the ECS, you need to add a security group rule allowing the ECS to access the DB instance.

  2. You have installed a database client to connect to DB instances.

    You can use a database client to connect to the target DB instance in Linux or Windows.

    • In Linux, install a MariaDB client on a device that can access RDS. It is recommended that you download a MariaDB client running a version later than that of the DB instance.

Connecting to a DB Instance Using Commands (SSL Connection)

  1. Log in to the management console.
  2. Click in the upper left corner of the page and choose Databases > Relational Database Service.
  3. On the Instances page, click the instance name to go to the Basic Information page.
  4. In the DB Information area, check whether SSL is enabled.

    • If yes, go to 5.
    • If no, click . In the displayed dialog box, click OK. Then, go to 6.

  5. Click next to the SSL field to download Certificate Download.zip, and extract the root certificate ca.pem and bundle ca-bundle.pem from the package.
  6. Import the root certificate ca.pem to the Linux or Windows.
  7. Connect to the RDS for MariaDB instance. In Linux, for example, run the following command:

    • Method 1

      mysql -h <host> -P <port> -u <userName> -p --ssl-ca=<caName>

      Example:

      mysql -h 172.16.0.31 -P 3306-u root -p --ssl-ca=ca.pem

    • Method 2

      mysql -h <host> -P <port> -u <userName> -p --ssl-capath=<caPath>

    Table 1 Parameter description

    Parameter

    Description

    <host>

    Floating IP address. To obtain this parameter, go to the Basic Information page of the DB instance and view the floating IP address in the Connection Information area.

    <port>

    Database port. By default, the value is 3306. To obtain this parameter, go to the Basic Information page of the DB instance and view the database port in the Connection Information area.

    <userName>

    Database account used for logging in to the DB instance. The default value is root.

    <caName>

    Name of the CA certificate. The certificate should be stored in the directory where the command is executed.

    <caPath>

    Path of the CA certificate.

  8. Enter the password of the database account if the following information is displayed: 

    Enter password:
    Figure 1 Connection example