All Products
Search
Document Center

ApsaraDB for SelectDB:Use DBeaver to visualize data

Last Updated:Mar 28, 2026

Connect DBeaver Community to ApsaraDB for SelectDB to manage your databases visually—browsing schemas, running SQL queries, and inspecting table data without writing CLI commands.

Prerequisites

Before you begin, ensure that you have:

  • Network access configured based on where DBeaver runs:

    • If DBeaver runs on an Elastic Compute Service (ECS) instance in the same virtual private cloud (VPC) as your ApsaraDB for SelectDB instance, no extra network setup is needed. Get the VPC endpoint of the instance.

    • In all other cases, apply for a public endpoint for the instance. See Apply for or release a public endpoint.

  • DBeaver Community downloaded and installed from dbeaver.io. The database driver must be compatible with MySQL 5.7.

  • The IP address of your DBeaver host added to the IP address whitelist of the ApsaraDB for SelectDB instance. See Configure an IP address whitelist.

  • Login credentials (username and password) for the ApsaraDB for SelectDB instance.

1. Gather your connection details

Before opening DBeaver, collect the following from the Instance Details page of your ApsaraDB for SelectDB instance. All values are in the Network Information section.

DetailWhere to find itExample
EndpointVPC endpoint or public endpoint in Network Informationselectdb-cn-xxx-public.selectdbfe.rds.aliyuncs.com
PortMySQL port number in Network Information9030
Database nameThe database you want to connect totest_db
UsernameYour instance login usernameadmin
PasswordYour instance login password. If forgotten, click Reset Password on the Instance Details page

2. Add a MySQL connection in DBeaver

  1. Open DBeaver Community.

  2. In the top navigation bar, choose image > MySQL.

  3. In the Connect to a database dialog box, fill in the connection parameters: For the full list of DBeaver connection parameters, see DBeaver Community documentation.

    Important

    The password example above is for reference only. Do not use it in production.

    ParameterDescriptionExample
    Connect byConnection method. Select HostServer Host
    Server AddressThe VPC endpoint or public endpoint of the instanceselectdb-cn-xxx-public.selectdbfe.rds.aliyuncs.com
    PortThe MySQL port number of the instance9030
    DatabaseThe database nametest_db
    UsernameYour instance login usernameadmin
    PasswordYour instance login passwordTestPassd@
  4. Click Finish to save the connection.