All Products
Search
Document Center

PolarDB:Manage databases

Last Updated:Mar 28, 2026

Create and delete databases in a PolarDB cluster from the PolarDB console.

Prerequisites

Before you begin, ensure that you have:

Create a database

  1. Log on to the PolarDB console. In the left navigation pane, click Clusters. Select the region of the cluster, then click the cluster ID.

  2. In the left navigation pane, click Settings and Management > Databases.

  3. Click Create Database.

  4. In the Create Database panel, configure the following parameters and click OK.

    ParameterDescription
    Database nameMust start with a letter and end with a letter or a digit. Can contain only lowercase letters, digits, underscores (_), and hyphens (-). Maximum 64 characters. Must be unique within the cluster. Do not use reserved keywords such as test or mysql.
    Supported character setCharacter set for the database: utf8mb4, utf8, gbk, or latin1.
    CollateCollation for the database. To view valid values, open the Create Database panel in the console at Configuration And Management > Database Management.
    Authorized accountAccounts to grant access to this database. Leave blank to configure access after the database is created. Only standard accounts appear here — privileged accounts have full access to all databases and do not require authorization.
    Account permissionsPermissions for the authorized account: Read/Write, Read-only, DML Only, DDL Only, or Read-only + Index.
    DescriptionAn optional description to help with future management. Cannot start with http:// or https://. Must be 2–256 characters.

Delete a database

  1. Log on to the PolarDB console. In the left navigation pane, click Clusters. Select the region of the cluster, then click the cluster ID.

  2. In the left navigation pane, click Settings and Management > Databases.

  3. Find the database and click Delete in the Actions column.

  4. In the dialog box, click OK.

FAQ

"Operation failed. The specified database name already exists." when creating a database

This error means a database with that name already exists in the cluster. To see all existing databases, connect to the cluster and run:

SHOW DATABASES;

API reference

APIDescription
CreateDatabaseCreates a database.
DescribeDatabasesQueries information about databases.
ModifyDBDescriptionModifies the description of a database.
DeleteDatabaseDeletes a database.