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

前提条件

RDS PostgreSQL实例需满足以下要求：
  • 实例为云盘版实例。
  • 实例大版本为RDS PostgreSQL 10或以上版本。

背景信息

RDS PostgreSQL实例提供两种参数模板，具体如下：
  • 系统参数模板：创建RDS PostgreSQL实例时，使用的默认参数模板。
  • 自定义参数模板：实例创建成功后，您可以根据业务需要，自定义参数模板，应用到一个或多个RDS PostgreSQL实例，覆盖系统参数模板。
说明 如果仅需要修改单个实例的某个参数，请参见设置实例参数。

新建自定义参数模板

手动新建参数模板

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

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

  1. 访问RDS实例列表，在上方选择地域，然后单击目标实例ID。
  2. 在左侧导航栏单击参数设置。
  3. 在可修改参数页签中，单击导出为模板。导出为模板
  4. 设置导出的模板名称和描述。
    参数 说明
    模板名称 模板的名称。由英文、数字、小数点（.）或下划线（_）组成，以字母开头，不能包含中文，长度为8~64个字符。
    描述 备注该模板的相关信息，便于后续管理。长度为0~200个字符。
  5. 单击确定，完成导出。
    您可以登录RDS管理控制台，在左侧导航栏单击参数模板，然后在上方选择地域，查看已导出的模板。

应用参数模板

创建实例时应用参数模板

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

批量应用参数模板

  1. 登录RDS管理控制台，在左侧导航栏单击参数模板，然后在上方选择地域。
  2. 在自定义参数模板或系统参数模板页签找到要应用的模板，单击其右侧操作列的应用到实例。
    说明 如果一个实例被依次应用了多个模板，则最后一模板会覆盖之前应用的参数模板。
  3. 在左侧实例列表中选择需要应用参数模板的实例，单击>移动到右侧，并查看参数对比，检查参数修改是否符合预期。
    重要
    • 应用参数模板到多个实例上时请确认参数是否适用这些实例，请您谨慎操作。
    • 部分参数修改在应用时会立即重启实例，详情请参见控制台参数模板的是否需要重启列说明。重启实例会造成连接中断，重启前请做好业务安排，谨慎操作。
  4. 单击确定。

应用参数模板到单个实例

  1. 访问RDS实例列表，在上方选择地域，然后单击目标实例ID。
  2. 在左侧导航栏单击参数设置。
  3. 在可修改参数页签中，单击应用模板。应用模板
  4. 选择可应用的模板名称。
    说明 您可以登录RDS管理控制台，在左侧导航栏单击参数模板，然后在上方选择地域，查看已创建的模板。
  5. 单击确定，完成应用。
    重要 部分参数修改在应用时会立即重启实例，详情请参见控制台应用模板确认框中的是否需要重启说明。重启实例会造成连接中断，重启前请做好业务安排，谨慎操作。

管理参数模板

复制自定义参数模板

如果您需要将当前地域的自定义参数模板复制到其他地域，或希望保留当前自定义参数模板，并在此基础上对模板进行修改，则可以使用复制参数模板功能。
说明 自定义参数模板支持复制，系统参数模板不支持复制。
  1. 登录RDS管理控制台，在左侧导航栏单击参数模板，然后在上方选择地域。
  2. 在自定义参数模板右侧，单击操作列下的图标，选择复制创建。
  3. 设置如下参数。
    参数 说明
    地域 需要复制到的目标地域。
    模板名称 模板的名称。由英文、数字、小数点（.）或下划线（_）组成，以字母开头，不能包含中文，长度为8~64个字符。
    描述 备注该模板的相关信息，便于后续管理。长度为0~200个字符。
  4. 单击确定。

查看参数模板

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

修改参数模板

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

重要 如果您修改了自定义参数模板，则需要重新应用模板后，修改的参数才会生效。如果修改的参数涉及重启实例，则会重启实例，造成连接中断，重启前请做好业务安排，谨慎操作。
  1. 登录RDS管理控制台，在左侧导航栏单击参数模板，然后在上方选择地域。
  2. 在目标自定义参数模板右侧，单击操作列下的图标，选择修改。
  3. 修改完成后，单击确定。

删除参数模板

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

  1. 登录RDS管理控制台，在左侧导航栏单击参数模板，然后在上方选择地域。
  2. 在目标自定义参数模板右侧，单击操作列下的图标，选择删除。
  3. 在删除确认对话框中，单击确定。
    说明

    如果目标自定义参数模板已被应用到1个或多个实例，则无法直接删除。

    例如：自定义参数模板1已被应用到实例A和实例B，自定义参数模板1无法直接删除，如果需要删除，则需要分别为实例A和实例B应用其他模板后，才可以删除。

相关API

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

常见问题

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

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