文档

设置实例参数

更新时间:

RDS MySQL支持通过控制台或API修改参数配置与查询参数修改历史,以满足您个性化调整实例参数来适应业务的需求。如需查询实例的参数配置,请参见查看实例参数

注意事项

  • 为保证实例的稳定,仅支持对控制台中开放的参数进行修改,未在控制台呈现或控制台中无法编辑的参数,不支持修改。

  • 修改参数值时请参见控制台上可修改参数页面中的可修改参数值列。您也可以将实例参数设置为表达式形式,使参数自适应实例配置的变更,详情请参见表达式参数

  • 部分参数在主实例被修改后会自动同步到该主实例下的所有只读实例中(如有),该部分参数列表请参见附录:会同步修改到只读实例的参数列表

  • MySQL 8.0版本lower_case_table_names参数取值固定为1,不支持修改。

重要

参数的修改与生效会涉及重启实例或重新连接数据库操作,建议您在业务低峰期操作,并确保应用程序具有重连机制:

  • 部分参数修改后需要重启实例才会生效,具体请参见控制台可修改参数页面中是否重启列。在您修改参数时,系统也会提示是否重启

  • 不需要重启实例的参数修改,会应用于新的数据库连接,已存在的数据库连接需要断开并重连才会生效。

修改实例参数

修改单个实例的参数

  1. 访问RDS实例列表,在上方选择地域,然后单击目标实例ID。

  2. 在左侧导航栏中单击参数设置

  3. 您可以进行如下操作:

    修改单个参数

    1. 可修改参数页签内找到需要修改的参数,根据不同的情况修改参数值:

      • 单击运行参数值列的铅笔,根据提示的取值范围输入参数值。

      • 运行参数值列的下拉列表中选择参数值。

    2. 单击确定

    3. 单击提交参数,并在弹出的窗口中,选择生效的时间段,您可以选择立刻生效可维护时间段生效用户指定时间段生效

    4. (可选)参数修改未提交前,如您需要取消修改,请单击撤销

    应用与导出参数模板

    应用参数模板

    为了满足不同的业务场景需求(如追求更高性能),RDS提供各类系统参数模板供您选择,您也可以创建自定义参数模板,根据自己的业务场景,实现批量参数设置。详情请参见使用参数模板

    1. 单击应用模板

    2. 选择需要应用的参数模板,单击确定

      说明
      • 您可以查看该参数模板的参数个数,以及是否需要重启实例。如果需要查看更详细的参数变更情况,请单击查看变更参数

      • 如果找不到参数模板,请确认参数模板所在地域和该实例所在地域是否一致。如果不在相同地域,您可以复制实例模板到该实例所在地域。详情请参见使用参数模板

    导出参数模板

    1. 单击导出为模板

    2. 设置如下参数。

      参数

      说明

      模板名称

      模板的名称。由英文、数字、小数点(.)或下划线(_)组成,以字母开头,不能包含中文,长度为8~64个字符。

      描述

      备注该模板的相关信息,便于后续管理。长度为0~200个字符。

    3. 单击确定即可在该地域创建一个新的参数模板。

    导入与导出参数(TXT格式)

    如您需要大量修改参数或获取实例参数配置,您可以导出TXT格式的参数文件到本地(该文件包含实例的所有参数值),参数修改完成后,将其导入到RDS实例中应用参数修改。

    1. 单击导出参数,将TXT格式的参数配置文件导出到本地。

    2. 参数配置文件修改完成后,可以单击导入参数,将参数文件内容粘贴到对话框中。

    3. 单击确定

    4. 单击提交参数,并在弹出的窗口中,选择生效的时间段,您可以选择立刻生效可维护时间段生效用户指定时间段生效

    5. (可选)参数修改未提交前,如您需要取消修改,请单击撤销

      重要

      如果出现操作失败,指定的参数格式不合法。的错误提示,请检查您更改的参数信息是否在该参数的参数值范围内。

批量变更多个实例的参数

  1. 登录RDS管理控制台,在左侧单击实例列表,然后在上方选择地域。

  2. 选中多个目标实例左侧的复选框,在页面底部单击变更参数

    说明

    同时变更参数的实例必须是相同版本、相同系列,否则变更参数按钮为灰色,无法单击。

  3. 在弹出的设置参数页面,单击需要修改的参数名最右侧的编辑图标。

  4. 配置值的框中选择或输入新的值,单击确定

  5. 在弹出的参数设置窗口中,确认此次修改是否正确,并单击确定

查询参数修改历史

  1. 访问RDS实例列表,在上方选择地域,然后单击目标实例ID。

  2. 在左侧导航栏中单击参数设置

  3. 单击参数修改历史页签。

  4. 选择要查询的时间范围,单击确定

常见问题

  • 修改实例参数立刻生效吗?需要重启吗?

    部分参数修改后不需要重启实例,通常5分钟左右可以生效;部分参数修改后需要重启实例才生效,具体请参见控制台上可修改参数页面中的是否重启列。

  • 修改参数后为什么没有反应?

    请确保您设置参数值后单击了提交参数,修改参数的任务才会执行。

  • 如果只读实例是高可用系列实例,有主实例和备实例,如何设置这两个主备只读实例的参数?

    只需要在主只读实例上设置参数,备只读实例会自动同步主只读实例上的参数值。不能直接修改备只读实例的参数。

附录:会同步修改到只读实例的参数列表

RDS MySQL的部分参数会在主实例中被修改后,自动同步到该主实例下的所有只读实例中(如有),下面列举这部分参数。

  • lower_case_table_names

    说明

    RDS MySQL 8.0不支持修改该参数。

  • innodb_large_prefix

  • loose_validate_password_length

  • default_time_zone

  • rpl_semi_sync_slave_enabled

相关API

API

描述

修改实例参数

调用ModifyParameter接口修改RDS实例参数。

查询参数取值范围及默认值

调用DescribeParameterTemplates接口查看数据库参数模板。

查询参数配置

调用DescribeParameters接口查询实例当前的参数配置。