- 文档首页
云数据库 MySQL 版
用户指南
参数管理
批量修改参数
批量修改参数
云数据库 MySQL 版支持批量修改参数功能,您可以为业务需求一致的实例同时修改参数。本文介绍如何批量修改参数的操作步骤。
前提条件
- 已创建实例且实例处于运行中状态。具体操作,请参见创建实例。
- 批量设置参数时,请确保所有实例的参数变更需求一致。
- 如果您希望在修改参数时为参数配置动态表达式,需确认该参数支持动态配置,并确认该实例应用的参数模板中已为该参数配置了动态表达式。
注意事项
- 为保证实例的稳定,控制台仅开放部分参数的修改,如果找不到需要修改的参数,请提交工单处理。
- 参数值的设定请参见控制台上 MySQL 参数页签中的可修改参数范围列。
- 部分参数修改后需要重启实例,具体请参见可修改参数列表:MySQL 5.7、MySQL 8.0 和 MySQL 8.4。重启实例一般会在 30~60 秒完成,中间可能会有 1~2 次闪断。建议您在业务低峰期操作,并增加应用程序的重连机制,可以大幅降低数据库连接闪断对业务的影响。
- MySQL 底层逻辑将会自动调整部分参数为预设限制值或预设数值的整倍数,调整规则如下:
- 若设置的参数值超出该参数的合法取值范围,系统不会自动调整,修改操作会直接失败。
- 若设置的参数值在该参数的合法取值范围内,但不满足该参数要求的数值倍数关系(如 block_size),系统会在异步执行阶段将该值向下取整为符合要求的最接近值,因此最终生效的值可能与您设置的值存在差异。
- 但对于 innodb_buffer_pool_size 参数,系统会逐一校验参数修改应用范围(即 ParamApplyScope)中的每个目标节点,检查其取值是否在目标节点内存的 50%~85% 范围内,并按 innodb_buffer_pool_chunk_size*innodb_buffer_pool_instances 对齐取整。
- 更多关于参数的自动调整逻辑的详细信息,请参见参数修改规则。
- 不同内核版本的数据库实例支持的参数存在差异。在修改批量实例的参数时,系统将自动忽略实例当前内核版本不支持的参数。关于不同内核版本支持的可修改参数的详细信息,请参见以下文档:
操作步骤
说明
如未设置实例的所属项目,本操作应选择项目为账号全部资源。
- 在实例列表页面,选择多个数据库版本相同的目标实例。
- 单击实例列表页面左下方的 ... > 修改参数。
- 在弹出的修改参数对话框中完成以下设置后,单击确定。
- 选择参数的修改范围。可选择所有节点、仅主备或仅只读。
- 找到目标参数,单击目标参数配置值列的编辑按钮,输入修改后的参数值或表达式。
说明
- 单击取消,退出修改参数对话框,所有参数均未被修改。
- 选择实例涉及的参数值可能不同,列表中的配置值均为默认推荐值,单击确认后仅会对用户修改过的值进行批量提交。
- 若修改的参数中包含了需要重启的参数,则会弹出重启风险提示对话框,确认可以重启实例后,单击确定。
- 在弹出的批量任务已发起对话框查看任务进度,任务执行完成后,单击确定。
说明
- 您可以在批量任务已发起对话框,单击终止按钮,终止后未开始变更的实例的任务将不再进行,也不能恢复。若想再次进行变更,您需要重新发起批量任务。
- 若任务执行失败,将光标指向执行结果列的失败,即可查看失败原因。
常见问题
在参数管理中为什么找不到需要修改的参数?
修改参数后,需要重启实例吗?
部分参数修改后需要重启实例,您可在控制台的参数配置>MySQL 参数的是否重启生效列查看是否需要重启实例,详情请参见修改参数。 说明
建议在业务低峰期操作,并确保应用程序具有重连机制。
支持修改系统参数模板吗?
如何查询云数据库 MySQL 版不支持修改的参数的设定值?
可登录数据库工作台,使用 SQL 语句 SHOW variables like '参数名'查看。
最近更新时间:2026.10.16 15:31:05