文档中心

文档数据库 MongoDB 版

参数模板管理

应用参数模板

本文介绍如何将参数模板应用于目标实例。

前提条件

实例类型需为副本集实例。关于副本集实例的更多信息，请参见产品架构。

实例状态需为运行中。关于实例状态的更多详情，请参见实例状态。

注意事项

目标实例的数据库版本需与待应用的参数模板数据库版本一致。例如，参数模板支持的数据库版本为 MongoDB 6.0，那么该参数模板仅支持应用于 MongoDB 6.0 版本的实例。

如果需要应用的参数模板中包含了需要重启的参数，应用该参数模板后实例会重启。重启实例一般需要 30 秒 ~ 60 秒完成，中间可能会有 1 次 ~ 2 次闪断，请谨慎操作。建议在业务低峰期执行该操作，并确保应用具备自动重连机制。

每个参数模板每次最多可批量应用于 10 个实例。

应用于单个实例

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

在左侧导航栏中选择 NoSQL 数据库 > MongoDB > 副本集实例列表。

在副本集实例列表页面，单击目标实例名称。

在实例详情页，单击参数管理页签。

在当前参数子页签，单击应用参数模板。

在弹出的对话框中，从选择模板的下拉列表中选择需要应用的模板。

说明

目标实例的数据库版本需与待应用的参数模板数据库版本一致。例如，参数模板支持的数据库版本为 MongoDB 6.0，那么该参数模板仅支持应用于 MongoDB 6.0 版本的实例。

选择参数模板后，会出现参数值对比列表，请在列表中确认将要修改的参数详情，包括参数名称，修改前后的参数值，以及是否需要重启生效。

如果需要应用的参数模板中包含了需要重启的参数，应用该参数模板后实例会重启。重启实例一般需要 30 秒 ~ 60 秒完成，中间可能会有 1 次 ~ 2 次闪断，请谨慎操作。建议在业务低峰期执行该操作，并确保应用具备自动重连机制。

单击确定。

应用于多个实例

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

在左侧导航栏中选择 NoSQL 数据库 > MongoDB > 副本集实例列表。

在副本集实例列表页面，勾选需要批量应用统一参数模板的目标实例。

说明

每个参数模板每次最多可批量应用于 10 个实例。

仅允许勾选实例状态为运行中且数据库版本相同的实例。

在实例列表左下角选择 ... > 应用参数模板。

在弹出的批量应用参数模板控制面板中执行如下操作：

选择模板。

在已选实例区域确认需要应用该模板的实例信息，并在参数模板区域选中要应用的模板。

单击右下角的下一步。

确认应用。

在确认信息区域，确认此次需要应用的实例，以及本次应用涉及的参数信，包括参数名称、修改前后的参数值、是否需要重启生效。

说明

如果需要应用的参数模板中包含了需要重启的参数，应用该参数模板后实例会重启。重启实例一般需要 30 秒 ~ 60 秒完成，中间可能会有 1 次 ~ 2 次闪断，请谨慎操作。建议在业务低峰期执行该操作，并确保应用具备自动重连机制。

单击右下角的确定。

说明

单击确定后，会弹出批量任务已发起的弹窗。您可以在弹窗中执行如下操作：

查看本次参数模板应用任务的详细信息，包括任务进度，任务总数，单个任务的执行结果等。

针对执行失败的任务，您可以单击对应实例右侧操作列的重试，来重新发起针对该实例的参数模板应用任务。

单击右下角的批量重试，来重新发起针对所有执行失败实例的参数模板应用任务。

单击左下角的终止来终止本次批量应用参数模板操作，此时所有运行中或等待中的任务都会被终止。

单击右下角的确定，来关闭该弹窗。

后续操作

参数模板应用成功后，您可以在修改历史页签下，查看本次参数模板应用中所修改参数的修改记录，包括已修改参数的名称、修改前后的参数值、参数修改状态、修改时间等。具体操作步骤，请参见查看参数修改历史。

最近更新时间：2026.09.14 16:01:35

这个页面对您有帮助吗？

有用

无用