All Products
Search
Document Center

PolarDB:Connect to a PolarDB cluster

Last Updated:Jul 25, 2023

This topic describes how to use Data Management (DMS) or a client to connect to a PolarDB cluster.

Prerequisites

Use DMS to connect to a PolarDB cluster

DMS provides an integrated data management solution. DMS supports data management, schema management, access control, BI charts, trend analysis, data tracking, performance optimization, and server management. DMS allows you to manage relational databases such as MySQL, SQL Server, and PostgreSQL, as well as NoSQL databases such as MongoDB and Redis. DMS also allows you to manage Linux servers.

  1. Log on to the PolarDB console.
  2. In the upper-left corner of the console, select the region in which the cluster that you want to manage is deployed.
  3. Find the cluster and click the cluster ID.
  4. In the upper-right corner of the Overview page, click Log On to Database.

  5. In the dialog box that appears, enter the database account and password that you create in the PolarDB cluster.

  6. Click Login.

    Note

    If you are using DMS to connect to the PolarDB cluster for the first time, you are prompted to set the whitelist. Click Configure Whitelist to complete the authorization.

  7. After you log on to DMS, refresh the page. In the left-side navigation pane, click Logged in instance.

  8. Find and double-click the name of the database that you want to manage. Then, you can manage the database.

Use a client to connect to a PolarDB cluster

You can also use your pgAdmin 4 client to connect to a PolarDB cluster.

  1. Launch the pgAdmin 4 client.

  2. Right-click Servers and choose Create > Server, as shown in the following figure.

    Create a server
  3. On the General tab of the Create - Server dialog box, enter the name of the server, as shown in the following figure.

    pgAdmin 4 - General
  4. Click the Connection tab and specify the information about the cluster that you want to connect to. The following table describes the parameters.

    pgAdmin 4 - Connection
    Table 1. Parameter description

    Parameter

    Description

    Host name/address

    The endpoint of the PolarDB cluster. To view the endpoint and port information about the PolarDB cluster, perform the following steps:

    1. Log on to the PolarDB console.

    2. In the upper-left corner of the console, select the region where the cluster is deployed.

    3. On the Clusters page, click the ID of the cluster that you want to manage.

    4. In the Endpoints section, view the endpoints of the PolarDB cluster.

    Port

    The port for the PolarDB for PostgreSQL(Compatible with Oracle) cluster. Default value: 1521.

    Maintenance database

    The maintenance database. Default value: postgres.

    Username

    The account of the PolarDB cluster. For more information about how to create an account, see Create database accounts.

    Password

    The password of the account for the PolarDB cluster.

  5. Click Save.

  6. If the connection information is valid, a page that is similar to the following page appears after you click the database name. This indicates that the database is connected.

    Connection established
  7. Right-click the name of the database that you want to manage and click Query Tool.... On the page that appears, you can add, delete, update, and query data in the database.

    Query editor

Use psql to connect to a PolarDB cluster

In addition to the preceding methods of connecting to your PolarDB cluster, you can also download and install a PostgreSQL client and use psql to connect to your PolarDB cluster.

Note
  • The method of using psql to connect to your PolarDB cluster for Windows operating systems is the same as that for Linux operating systems.

  • For more information about how to use psql, see psql.

  1. Enter the following command in the psql command line interface (CLI) and press Enter:

    psql -U <username> -h <host> -p <port> <dbname>

    Parameter

    Description

    username

    The account of the PolarDB cluster. For more information about how to create an account, see Create database accounts.

    host

    The endpoint of the PolarDB cluster. To view the endpoint and port information about the PolarDB cluster, perform the following steps:

    1. Log on to the PolarDB console.

    2. In the upper-left corner of the console, select the region where the cluster is deployed.

    3. On the Clusters page, click the ID of the cluster that you want to manage.

    4. In the Endpoints section, view the endpoints of the PolarDB cluster.

    port

    The port for the PolarDB cluster. Default value: 1521.

    dbname

    The name of the maintenance database that you want to manage. For more information about how to create a database, see Create a database.

    The following code provides an example:

    psql -U testuser -h hostname -p 1521 testdb
  2. Enter the password of the specified username and press Enter. Then, the connection is established.

What to do next

Oracle compatibility

Troubleshooting

  • The IP address whitelist is invalid.

    • The default whitelist contains only the IP address 127.0.0.1. 127.0.0.1 indicates that no IP address is allowed to access the PolarDB cluster. Therefore, you must add the IP addresses of the clients that you use to access your cluster to the whitelist. For more information, see Configure a whitelist for a cluster.

    • The entry in the whitelist is set to 0.0.0.0. The valid format is 0.0.0.0/0.

      Important

      0.0.0.0/0 indicates that all IP addresses are allowed to access the PolarDB cluster. Proceed with caution.

    • The public IP addresses that you add to the whitelist are invalid. For example, the public IP addresses may be dynamic IP addresses, or the tools or websites used to check the public IP addresses provide invalid IP addresses.

  • The internal or public endpoint is incorrectly used.

    If you use an internal endpoint to establish a connection over the Internet or use a public endpoint to establish a connection over an internal network, the connection fails.

    Use the required endpoint. If you want to connect to the PolarDB cluster over an internal network, use an internal endpoint of the PolarDB cluster. If you want to connect to the PolarDB cluster over the Internet, use a public endpoint of the PolarDB cluster.

  • A Domain Name System (DNS) server fails to resolve the endpoint of your cluster.

    • The endpoint that you enter to connect to the PolarDB cluster is invalid. In this case, troubleshoot the issue:

      • The endpoint of the PolarDB cluster is invalid. In this case, view the valid endpoints in the PolarDB console. For more information, see View endpoints and ports.

      • The endpoint that you enter is a public endpoint. However, the public endpoint is manually deleted.

      • Some applications have limits on the length of endpoints and the endpoint you enter is truncated.

    • If the endpoint of the PolarDB cluster is valid, change the IP address of the DNS server to that of the Alibaba Cloud DNS server.

      Network type

      IP address of the Alibaba Cloud DNS server

      Internal network (classic network)

      10.143.22.116

      10.143.22.118

      Internal network (virtual private cloud)

      100.100.2.136

      100.100.2.138

      Internet

      223.5.5.5

      223.6.6.6