All Products
Search
Document Center

ApsaraDB for SelectDB:Manage database users and roles

Last Updated:Mar 28, 2026

The Permission Settings tool lets you create, delete, and manage database users and roles for an ApsaraDB for SelectDB instance directly from the console—no SQL required.

Prerequisites

Before you begin, make sure you have:

Open Permission Settings

  1. Log on to the ApsaraDB for SelectDB console.

  2. In the top navigation bar, select the region where your instance resides.

  3. In the left-side navigation pane, click Instances. Find the instance and click its ID to go to the Instance Details page.

  4. In the upper-right corner, click Data Development and Management.

    Note

    The first time you use Data Development and Management, a message prompts you to add your machine's public IP address to the IP address whitelist named webui_whitelist. Click OK to proceed.

  5. From the drop-down list, select Permission Settings.

    Note

    The first time you open Permission Settings, the WebUI login page appears. Log on with the admin account. If you have forgotten the password, see Reset the password of an account. The Users page opens by default and lists all users except the root user.

Manage users

In the left-side navigation pane, choose Privileges > Users.

Important

The admin user cannot be deleted, and its roles and permissions cannot be modified. Only users with ADMIN permissions can modify roles, change passwords, delete users, or modify permissions for other users.

Create a user

  1. Click New User in the upper-left corner.

  2. In the New User dialog box, fill in the following fields.

    ParameterRequiredDescriptionExample
    User NameYesThe name of the user.test_account
    HostNoThe IP address from which the user's login requests originate.127.0.0.1
    PasswordYesThe password for the user.
    Granted RoleNoOne or more roles to assign to the user.admin
  3. Click Confirm.

Edit a user's roles

  1. In the Actions column, click the image icon next to the user, then select Edit Role.

  2. In the Edit User dialog box, select one or more roles from the Granted Role drop-down list.

  3. Click Confirm.

Change a user's password

  1. In the Actions column, click the image icon next to the user, then select Change Password.

  2. In the Change Password dialog box, enter a new password in the New Password field.

  3. Click Confirm.

Delete a user

Important

Deleted users cannot be recovered.

  1. In the Actions column, click the image icon next to the user, then select Delete User.

  2. In the confirmation message, click Confirm.

Grant permissions to a user

  1. Click the user's name to go to the Privileges page.

  2. Find the permission type, then click Privileges in the upper-right corner of that section.

  3. In the dialog box, select the permissions to grant and click Confirm.

For a full list of available permissions, see Manage the basic permissions of users.

Revoke permissions from a user

  1. Click the user's name to go to the Privileges page.

  2. Find the permission to revoke, then click the image icon in the last column of that section.

  3. In the Revoke dialog box, select the permissions to revoke and click Revoke.

For a full list of available permissions, see Manage the basic permissions of users.

Manage roles

In the left-side navigation pane, choose Privileges > Roles.

Important

The admin role cannot be deleted. Only users with ADMIN permissions can delete roles or modify permissions for roles other than the admin role.

Create a role

  1. Click New Role in the upper-left corner.

  2. In the New Role dialog box, enter a name in the Name field.

  3. Click Confirm.

Delete a role

  1. In the Actions column, click the Delete icon next to the role.

  2. In the confirmation message, click Confirm.

Grant permissions to a role

  1. Click the role name to go to the Privileges page.

  2. Find the permission type, then click Privileges in the upper-right corner of that section.

  3. In the dialog box, select the permissions to grant and click Confirm.

For a full list of available permissions, see Permission management.

Revoke permissions from a role

  1. Click the role name to go to the Privileges page.

  2. Find the permission to revoke, then click the image icon in the last column of that section.

  3. In the Revoke dialog box, select the permissions to revoke and click Revoke.

For a full list of available permissions, see Permission management.

API reference

What's next