如果需要批量管理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. 重新应用参数模板到目标实例,具体操作请参见应用参数模板