Help Center/ Relational Database Service/ User Guide/ Working with RDS for MySQL/ Parameters/ Modifying Parameters of an RDS for MySQL Instance
Updated on 2025-11-11 GMT+08:00
View PDF

Modifying Parameters of an RDS for MySQL Instance

You can change parameter values in a custom parameter template and apply it to optimize RDS database performance.

You can only change the values in custom parameter templates. You cannot change the values in default parameter templates.

Global parameters can only be modified on the console. Session-level parameters can be modified using SQL statements. When you modify a parameter, the time when modifications take effect varies with the parameter type.

The RDS console displays the statuses of DB instances that the parameter template applies to. For example, if the DB instance has not yet used the latest modifications made to its parameter template, its status is Parameter change. Pending reboot. You need to manually reboot the DB instance for the latest modifications to take effect for that DB instance.

Constraints

  • For better parameter modification experience, you are advised to upgrade the minor version of your DB instance to the latest.
  • RDS has default parameter templates whose parameter values cannot be changed. You can view these parameter values by clicking the default parameter templates. If an instance cannot be started due to incorrect parameter settings of a parameter template, you can reconfigure the parameters based on the default parameter template.
  • Before modifying parameters, make sure you understand their meanings and fully verify the changes in a test environment to avoid instance or workload exceptions caused by inappropriate parameter settings.
  1. Log in to the management console.
  2. Click in the upper left corner of the page and choose Databases > Relational Database Service.
  3. Choose Parameter Templates in the navigation pane on the left. On the Custom Templates page, click the target parameter template.
  4. On the Parameters page, modify parameters as required.

    For parameter details, see Suggestions on RDS for MySQL Parameter Tuning.

    Available operations are as follows:

    • To save the modifications, click Save.
    • To cancel the modifications, click Cancel.
    • To preview the modifications, click Preview.

  5. Click Change History to view the changes.
  6. Apply the parameter template to your DB instance. For details, see Applying a Parameter Template.
  7. View the status of the DB instance to which the parameter template has been applied.

    If the DB instance status is Parameter change. Pending reboot, you need to reboot the DB instance for the modifications to take effect.

    • The DB instance reboot caused by instance class changes will not make parameter modifications take effect.
    • If you have modified parameters of a primary DB instance, you need to reboot the primary DB instance for the modifications to take effect. (For primary/standby DB instances, the parameter modifications are also applied to the standby DB instance.)
    • If you have modified parameters of a read replica, you need to reboot the read replica for the modifications to take effect.

  1. Log in to the management console.
  2. Click in the upper left corner of the page and choose Databases > Relational Database Service.
  3. On the Instances page, click the DB instance name.
  4. In the navigation pane on the left, choose Parameters. On the displayed page, modify parameters as required.

    • To save the modifications, click Save.
    • To cancel the modifications, click Cancel.
    • To preview the modifications, click Preview.

  5. After the parameters are modified, choose whether to reboot the instance based on the information in the Effective upon Reboot column.

    • If Yes is displayed and the DB instance status on the Instances page is Parameter change. Pending reboot, a reboot is required for the modifications to take effect.
      • If you have modified parameters of a primary DB instance, you need to reboot the primary DB instance for the modifications to take effect. (For primary/standby DB instances, the parameter modifications are also applied to the standby DB instance.)
      • If you have modified parameters of a read replica, you need to reboot the read replica for the modifications to take effect.
    • If No is displayed, the modifications take effect immediately.

  1. Log in to the management console.
  2. Click in the upper left corner of the page and choose Databases > Relational Database Service.
  3. On the Instances page, click the target instance name.
  4. In the navigation pane on the left, choose Parameters. On the displayed page, click Change History.

    You can view the parameter names, original parameter values, new parameter values, modification statuses, modification time, application statuses, and application time.

  1. Log in to the management console.
  2. Click in the upper left corner of the page and choose Databases > Relational Database Service.
  3. In the navigation pane, choose Parameter Templates. On the Custom Templates page, click the target parameter template.
  4. On the displayed page, choose Change History in the navigation pane.

    You can view the parameter names, original parameter values, new parameter values, modification statuses, and modification time.

    You can apply the parameter template to DB instances as required by referring to Applying a Parameter Template.

Parent Topic: Parameters