文档中心

云数据库 MySQL 版

参数管理

批量应用参数模板

本文介绍批量应用参数模板的相关操作步骤。

前提条件

已创建实例且实例处于运行中状态。具体操作，请参见创建实例。

已创建参数模板。具体操作，请参见创建模板。

注意事项

如果您选择的参数模板中包含了需要重启的参数，应用该参数模板后实例会重启。重启实例时间取决于实例的负载状态，会导致业务有 1~2 次闪断，请谨慎操作。建议您增加应用程序的重连机制，可以大幅降低数据库连接闪断对业务的影响。只读节点重启过程中，对应节点将不可用，当前只读节点负载将转移至满足条件的其他节点上，请在准确评估重启影响后进行操作。

仅支持对数据库版本相同的实例进行批量应用参数模板操作。在一次批量应用参数模板操作中，最多支持选择 10 个实例。

当参数模板的参数值为公式时，会根据每个节点的规格进行单独为节点计算参数的值。不同实例应用同一个参数模板后，同一个参数的值可能不同。在调整需要重启的参数时，系统会比较修改值与实例的当前值。如果修改值与当前值相同，则不会因为该参数重启实例。

对于 innodb_buffer_pool_size 参数，应用模板前，系统仍会对每个目标节点逐一校验其计算值是否在目标节点内存的 50%～85% 范围内；若校验不通过，该实例的模板应用请求将直接失败。

校验通过的合法值，会在进入异步执行阶段后，再按 block_size 及 innodb_buffer_pool_chunk_size*innodb_buffer_pool_instances 进行对齐取整。

为实例应用系统参数模板且选择修改范围为所有节点时，如果实例的数据同步方式与系统模板预设的方式不同，应用参数模板后会自动对数据同步方式进行调整。

MySQL 底层逻辑将会自动调整部分参数为预设限制值或预设数值的整数倍，调整规则如下：

若设置的参数值超出该参数的合法取值范围，系统不会自动调整，修改操作会直接失败。

若设置的参数值在该参数的合法取值范围内，但不满足该参数要求的数值倍数关系（如 block_size），系统会在异步执行阶段将该值向下取整为符合要求的最接近值，因此最终生效的值可能与您设置的值存在差异。

但对于 innodb_buffer_pool_size 参数，系统会逐一校验参数修改应用范围（即 ParamApplyScope）中的每个目标节点，检查其取值是否在目标节点内存的 50%～85% 范围内，并按 innodb_buffer_pool_chunk_size*innodb_buffer_pool_instances 对齐取整。

更多关于参数的自动调整逻辑的详细信息，请参见参数修改规则。

不同内核版本的数据库实例支持的参数存在差异。在修改批量实例的参数时，系统将自动忽略实例当前内核版本不支持的参数。关于不同内核版本支持的可修改参数的详细信息，请参见以下文档：

如数据库版本为 MySQL 5.7，请参见可修改参数列表（MySQL 5.7）。

如数据库版本为 MySQL 8.0，请参见可修改参数列表（MySQL 8.0）。

如数据库版本为 MySQL 8.4，请参见可修改参数列表（MySQL 8.4）。

关于更详细的参数修改规则信息，请参见参数修改规则。

为进一步提升云数据库 MySQL 版的安全防护等级，优化资源管理的权限管理，提供更精细的和更安全的资源管理服务，云数据库 MySQL 版的参数模板功能进行了升级，支持了项目鉴权能力。项目鉴权能力上线后，历史自定义参数模板会自动归属于“全局资源”项目。对于“全局资源”项目下的自定义参数模板，需在顶部导航栏选择“账号全部资源”项目后才能查看。

操作步骤

登录云数据库 MySQL 版控制台。

在顶部菜单栏选择实例所属的项目和地域。

说明

如未设置实例的所属项目，本操作应选择项目为账号全部资源。

在实例列表页面，选择多个目标实例。

单击实例列表页面左下方的 ... > 应用模板。

在批量应用参数模板页面，确认选择实例并选择要应用的模板，单击下一步。

在批量应用参数模板页面完成以下设置后，单击确定。

修改范围：可选择修改范围为所有节点、仅主备和仅只读。

说明

如所选实例均没有只读节点，修改范围默认为所有节点。

数据同步方式：确认实例的数据同步方式。

说明

当选择系统模板且修改范围为所有节点时，会根据所选择的参数模板调整数据同步方式。数据同步方式取决于参数模板的配置。

参数变化：参数变化列表列出了所选实例在应用参数模板后发生的参数变化，包含参数名称、修改前参数值、修改后参数值、是否需要重启实例、是否涉及公式以及涉及的公式和对应的节点。

说明

如果参数模板中有配置为公式的参数值，参数值会根据每个节点的规格进行单独计算，并将变化在参数变化列表按节点列出。

说明

若选择的参数模板中包含了需要重启的参数，则会弹出重启风险提示对话框，确认可以重启实例后，单击确定。

在弹出的批量任务已发起对话框查看任务进度，任务执行完成后，单击确定。

说明

您可以在批量任务已发起对话框，单击终止按钮，终止后未开始变更的实例的任务将不再进行，也不能恢复。若想再次进行变更，您需要重新发起批量任务。

若任务执行失败，将光标放置在执行结果列的失败上，即可查看失败原因。

最近更新时间：2026.10.16 15:31:05

这个页面对您有帮助吗？

有用

无用