Create master account

Last Updated: Dec 22, 2017

RDS supports the classic mode and the master mode. For instances of MySQL 5.5/5.6, you can create a master account to upgrade the account management mode from classic to master. Compared with the classic mode, the master mode enables more permissions to meet the personalized and sophisticated permission management needs. You can also use SQL to directly manage databases and accounts. Therefore, we recommend that you use the master mode.

This document describes how to upgrade the account management mode, namely to create a master account, of MySQL 5.5/5.6. For details about the usage, supported engines, functions, and permissions of accounts in the classic mode and master mode, see Create an account.

Backgroud information

After a master account is created for a master instance, it is synchronized to the read-only instances and disaster tolerance instances. In the master mode, you are not allowed to manage databases and common accounts on the RDS console or through APIs. You must use SQL commands or Alibaba Cloud DMS to perform relative operations. However, you can reset the permissions and password of the master account on the RDS console or through API, without affecting other accounts in the instance.

The following figure shows how to upgrade the account management mode of MySQL 5.5/5.6 from the classic mode to the master mode, and the difference of creating and managing databases/accounts between the two modes.


  • MySQL 5.5/5.6 only supports upgrade from the classic mode to the master mode and does not support rollback.

  • The following changes occur after an instance switches to the master account mode:

    • After the master account is created, the Databases page and Create Account on the Accounts page disappear. However, this change only affects the single instance and has nothing to do with other instances.

    • In MySQL 5.5/5.6, you cannot directly access the mysql.user and mysql.db tables, but you can view the existing account and permissions through mysql.user_view and mysql.db_view.

    • You cannot use the master account to modify passwords of other common accounts. To modify passwords of other common accounts, you must delete the master account and create a new account.

  • When the master account is created, the instance restarts once, causing a transient network disconnection in 30s. Make sure that you create an account at proper time, and the application supports auto-reconnection, to prevent disconnection impacts, if any.


  1. Log on to the RDS console.

  2. Select the region in which the target instance is located.

  3. Click the ID of the target instance to go to the Basic Information page of the instance.

  4. Select Accounts in the left-side navigation pane to go to the Accounts page.

  5. Click Create Master Account.

  6. Read the displayed text, click the checkbox, and click Next.

  7. Enter the relevant details in the required fields.

    Parameter descriptions:

    • Database Account: The account is a string of 2 to 16 characters. It must contain lowercase letters, numbers, and underscores (_). The account must start with a letter and end with a letter or a number.

    • Password: Password of the account. The password is a string of 8 to 32 characters. It must contain any three of letters, numbers, hyphens (-), and underscores (_).

    • Re-enter Password: Re-enter the password to verify that the password is entered correctly.

  8. Click Create.

    Note: After a master account is created, the account name cannot be modified, but the password can be modified later on the console.

Thank you! We've received your feedback.