All Products
Search
Document Center

AnalyticDB:DBeaver

Last Updated:Mar 28, 2026

Connect to an AnalyticDB for PostgreSQL instance from DBeaver. DBeaver runs on Windows, macOS, and Linux.

Prerequisites

Before you begin, make sure you have:

  • An endpoint and port. Use the internal endpoint if your client runs on an Elastic Compute Service (ECS) instance in the same region and network type as the AnalyticDB for PostgreSQL instance. Apply for a public endpoint if your client is in a different region, uses a different network type, or is outside Alibaba Cloud. For details, see Manage public endpoints.

  • Your client IP added to the instance whitelist. See Configure an IP address whitelist.

To find the endpoint and port, go to the AnalyticDB for PostgreSQL console, click the instance ID, and check the Database Connection Information section on the Basic Information page.

Connect to AnalyticDB for PostgreSQL

  1. Download and install DBeaver Community Edition.

  2. Start DBeaver, then choose Database > New Database Connection.

  3. In the Connect to a database dialog, select Greenplum and click Next.

    Note

    The first time you connect to an instance, you must download the corresponding database driver file.

  4. On the Main tab of the Connection Settings page, fill in the following parameters:

    ParameterDescriptionExample
    HostThe endpoint of the instance. In the Database Connection Information section of the Basic Information page, use Internal Endpoint for private connections or Public endpoint for public connections. 查看连接地址gp-bp1g*************-master.gpdbmaster.rds.aliyuncs.com
    PortThe port of the instance. Find it alongside the endpoint in the console.5432
    DatabaseThe name of the database.postgres
    UsernameThe database account. See Create a database account.testuser
    PasswordThe password for the database account.PassW0rd
  5. Click Test Connection. A Connected message confirms the connection is working. If you see an org.postgresql.Driver error, update the driver manually:

    1. On the Main tab, click Edit Driver Settings.

    2. On the Libraries tab, click Download/Update.

  6. Click Finish.