Help Center/ Relational Database Service/ User Guide (Kuala Lumpur Region)/ Getting Started with RDS for PostgreSQL/ Step 2: Connect to a DB Instance/ Connecting to a PostgreSQL DB Instance Through a Private Network/ Connecting to a DB Instance Through psql
Updated on 2022-08-16 GMT+08:00
View PDF
Share

Connecting to a DB Instance Through psql

You can use the PostgreSQL client psql to connect to a DB instance through a non-SSL connection or an SSL connection. The SSL connection is encrypted and therefore more secure.

Prerequisites

  1. You have logged in to the ECS.
    • To connect to a DB instance through an ECS, make sure that:
      • The ECS and DB instance must be in the same VPC.
      • The ECS must be allowed by the security group to access RDS DB instances.
        • If the security group with which the target DB instance is associated is the default security group, you do not need to configure security group rules.
        • If the security group with which the target DB instance is associated 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 security group rules allow the access from the ECS, the ECS can connect to the DB instance.

          If the security group rules do not allow the access from the ECS, you need to add a security group rule. The ECS must be allowed by the security group to access DB instances.

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

    For details, see How Can I Install the PostgreSQL Client?

Non-SSL Connection

  1. Log in to the ECS or the device that can access RDS.
  2. Run the following command to connect to the DB instance:

    psql --no-readline -U<user>-h<host>-p<port>-d<datastore>-W

    Table 1 Parameter description

    Parameter

    Description

    <user>

    Indicates the username of the RDS database account. The default administrator is root.

    <host>

    Indicates the IP address of the primary DB instance. To obtain this parameter, go to the Basic Information page of the DB instance. If the DB instance is accessed through the ECS, the IP address can be found in the Floating IP Address field in the Connection Information area.

    <port>

    Indicates the database port in use. The default value is 5432. To obtain this parameter, go to the Basic Information page of the DB instance. The port number can be found in the Database Port field in the Connection Information area.

    <datastore>

    Indicates the name of the database (the default database name is postgres).

    The parameter -W indicates that a password must be entered for the connection. After running this command, you will be prompted to enter a password.

    Example:

    Run the following command as user root to connect to a DB instance:

    psql --no-readline -U root -h 192.168.0.44 -p 5432 -d postgres -W