使用参数模板_云数据库 RDS(RDS)-阿里云帮助中心

如果需要批量管理RDS PostgreSQL实例的参数，您可以使用参数模板功能，快速应用模板到实例上。参数模板分为系统参数模板和自定义参数模板两类。

前提条件

RDS PostgreSQL实例需满足以下要求：

实例为云盘版实例。
实例大版本为RDS PostgreSQL 10或以上版本。

背景信息

RDS PostgreSQL实例提供两种参数模板，具体如下：

系统参数模板：创建RDS PostgreSQL实例时，使用的默认参数模板。
自定义参数模板：实例创建成功后，您可以根据业务需要，自定义参数模板，应用到一个或多个RDS PostgreSQL实例，覆盖系统参数模板。

说明

如果仅需要修改单个实例的某个参数，请参见设置实例参数。

新建自定义参数模板

手动新建参数模板

登录RDS管理控制台，在左侧导航栏单击参数模板，然后在上方选择地域。
在右侧页面中单击新建参数模板。

设置如下参数。

参数	说明
模板名称	模板的名称。由英文、数字、小数点（.）或下划线（_）组成，以字母开头，不能包含中文，长度为8~64个字符。
数据库引擎	选择PostgreSQL。
数据库版本	当前支持RDS PostgreSQL 10或以上版本。
描述	备注该模板的相关信息，便于后续管理。长度为0~200个字符。
添加参数	单击添加参数会增加一行参数供您选择参数名以及设置取值，您还可以看到取值范围、默认值等信息。说明可添加的参数请参见实例控制台参数设置页面的可修改参数。需要配置下一个参数，请再次单击添加参数。需要删除某个参数，请单击该参数右侧的删除。
导入	您可以将导出的模板修改好之后，单击导入，粘贴参数生成模板。导出模板请参见设置实例参数。

单击确认创建。

将现有实例参数导出为模板

访问RDS实例列表，在上方选择地域，然后单击目标实例ID。
在左侧导航栏单击参数设置。
在可修改参数页签中，单击导出为模板。

设置导出的模板名称和描述。

参数	说明
模板名称	模板的名称。由英文、数字、小数点（.）或下划线（_）组成，以字母开头，不能包含中文，长度为8~64个字符。
描述	备注该模板的相关信息，便于后续管理。长度为0~200个字符。

单击确定，完成导出。
您可以登录RDS管理控制台，在左侧导航栏单击参数模板，然后在上方选择地域，查看已导出的模板。

应用参数模板

创建实例时应用参数模板

创建实例时，支持为云盘实例设置参数模板。创建实例的具体步骤，请参见快速创建RDS PostgreSQL实例。

选择系统参数模板：RDS PostgreSQL默认提供参数模板，命名规则为PostgreSQL_大版本号_系列_默认参数模板，例如PostgreSQL_14.0_高可用系列_默认参数模板。系统参数模板的各参数设置情况，请参见查看参数模板。
选择自定义参数模板：您可以提前创建自定义参数模板，或单击参数模板后创建自定义参数模板链接，前往创建页面。创建自定义参数模板的具体操作，请参见新建自定义参数模板。

说明

系统参数模板不支持修改。

批量应用参数模板

警告

应用参数模板到多个实例上时请确认参数是否适用这些实例，请您谨慎操作。
部分参数修改在应用时会立即重启实例，详情请参见控制台参数模板的是否需要重启列说明。重启实例会造成连接中断，重启前请做好业务安排，谨慎操作。

登录RDS管理控制台，在左侧导航栏单击参数模板，然后在上方选择地域。
在自定义参数模板或系统参数模板页签找到要应用的模板，单击其右侧操作列的应用到实例。
说明
如果一个实例被依次应用了多个模板，则最后一模板会覆盖之前应用的参数模板。
在左侧实例列表中选择需要应用参数模板的实例，单击移动到右侧，并查看参数对比，检查参数修改是否符合预期。
单击确定。

应用参数模板到单个实例

警告

部分参数修改在应用时会立即重启实例，详情请参见控制台应用模板确认框中的是否需要重启说明。重启实例会造成连接中断，重启前请做好业务安排，谨慎操作。

访问RDS实例列表，在上方选择地域，然后单击目标实例ID。
在左侧导航栏单击参数设置。
在可修改参数页签中，单击应用模板。
选择可应用的模板名称。
说明
您可以登录RDS管理控制台，在左侧导航栏单击参数模板，然后在上方选择地域，查看已创建的模板。
单击确定，完成应用。

管理参数模板

复制自定义参数模板

如果您需要将当前地域的自定义参数模板复制到其他地域，或希望保留当前自定义参数模板，并在此基础上对模板进行修改，则可以使用复制参数模板功能。

说明

自定义参数模板支持复制，系统参数模板不支持复制。

登录RDS管理控制台，在左侧导航栏单击参数模板，然后在上方选择地域。
在自定义参数模板右侧，单击操作列下的，选择复制创建。

设置如下参数。

参数	说明
地域	需要复制到的目标地域。
模板名称	模板的名称。由英文、数字、小数点（.）或下划线（_）组成，以字母开头，不能包含中文，长度为8~64个字符。
描述	备注该模板的相关信息，便于后续管理。长度为0~200个字符。

单击确定。

查看参数模板

登录RDS管理控制台，在左侧导航栏单击参数模板，然后在上方选择地域。
在自定义参数模板或系统参数模板页签，单击目标参数模板ID即可查看参数模板内的参数配置情况。

修改参数模板

您可以修改已创建的自定义参数模板。

警告

如果您修改了自定义参数模板，则需要重新应用模板后，修改的参数才会生效。如果修改的参数涉及重启实例，则会重启实例，造成连接中断，重启前请做好业务安排，谨慎操作。

登录RDS管理控制台，在左侧导航栏单击参数模板，然后在上方选择地域。
在目标自定义参数模板右侧，单击操作列下的，选择修改。
修改完成后，单击确定。

删除参数模板

您可以删除已创建的自定义参数模板。

登录RDS管理控制台，在左侧导航栏单击参数模板，然后在上方选择地域。
在目标自定义参数模板右侧，单击操作列下的，选择删除。
在删除确认对话框中，单击确定。
说明
如果目标自定义参数模板已被应用到1个或多个实例，则无法直接删除。
例如：自定义参数模板1已被应用到实例A和实例B，自定义参数模板1无法直接删除，如果需要删除，则需要分别为实例A和实例B应用其他模板后，才可以删除。

常见问题

Q：如何将自定义参数模板中的参数值重置为默认值。

A：

在自定义参数模板中找到目标参数，将配置值改为默认值，具体操作请参见修改参数模板。
重新应用参数模板到目标实例，具体操作请参见应用参数模板。

API	描述
创建参数模板	调用CreateParameterGroup接口创建RDS参数模板。
修改参数模板	调用ModifyParameterGroup接口修改RDS参数模板。
复制参数模板	调用CloneParameterGroup接口复制RDS参数模板到当前地域或其他地域。
查询参数模板列表	调用DescribeParameterGroups接口查询目标地域的参数模板列表。
查询参数模板信息	调用DescribeParameterGroup接口查询指定的RDS参数模板信息。
删除参数模板	调用DeleteParameterGroup接口删除RDS参数模板。