All Products
Search
Document Center

ApsaraDB for ClickHouse:Connect using DMS

Last Updated:Mar 28, 2026

Data Management Service (DMS) is a web-based tool for connecting to and managing your ApsaraDB for ClickHouse cluster without a CLI. With DMS, you can:

  • Run SQL queries and view results in a browser-based SQL console

  • Create and manage databases and tables

  • Import and export data, clone databases, and run security audits

To connect from a terminal or application instead, see the other connection methods in the ApsaraDB for ClickHouse documentation.

Prerequisites

Before you begin, ensure that you have:

  • An ApsaraDB for ClickHouse cluster

  • A database account and password for the cluster

  • DMS server IP addresses in the cluster whitelist (added automatically when you create a new cluster; if automatic addition fails, add them manually using the ranges in DMS IP address ranges)

Log on to your cluster

  1. Log on to the ApsaraDB for ClickHouse console.

  2. In the upper-left corner, select the region where your cluster is located.

  3. On the Cluster List page, click the Instance List tab for your cluster type, then click the cluster ID.

  4. On the Cluster Information page, click Log On to Database in the upper-right corner.

  5. Configure the following parameters. To verify your credentials before logging on, click Test Connection in the lower-left corner. If the connection test fails, check the cluster information that you entered based on the error message.

    The first time you use DMS to log on to an ApsaraDB for ClickHouse cluster, the control mode defaults to Flexible Management. To change the control mode later, edit the instance. For details, see Edit an instance and Control modes.
    ParameterDescription
    Database typeDefaults to ClickHouse. No change required.
    Instance regionDefaults to the current cluster region. To log on to a cluster in a different region, select the region from the drop-down list.
    Instance IDDefaults to the current cluster ID. To log on to a different cluster, select the cluster ID from the drop-down list.
    Database accountThe account for the database.
    Database passwordThe password for the database account.
    Remember passwordSelect this option to log on automatically in the future without re-entering credentials.
  6. Click Log On.

Run a query

  1. In the SQL Console window, enter the SQL statement to execute.

  2. In the menu bar, click Execute (F8) and view the results.

The following example shows how to create a local table.

Create a local table

DMS supports various SQL statements and provides a visual interface for create, read, update, and delete (CRUD) operations. For details, see Introduction to the SQL window.

What's next