文档

使用参数模板

更新时间:
重要

本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。

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

前提条件

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

  • 实例为云盘版实例。

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

背景信息

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

  • 系统参数模板:创建RDS PostgreSQL实例时,使用的默认参数模板。

  • 自定义参数模板:实例创建成功后,您可以根据业务需要,自定义参数模板,应用到一个或多个RDS PostgreSQL实例,覆盖系统参数模板。

说明

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

新建自定义参数模板

手动新建参数模板

  1. 登录RDS管理控制台,在左侧导航栏单击参数模板,然后在上方选择地域。

  2. 在右侧页面中单击新建参数模板

  3. 设置如下参数。

    参数

    说明

    模板名称

    模板的名称。由英文、数字、小数点(.)或下划线(_)组成,以字母开头,不能包含中文,长度为8~64个字符。

    数据库引擎

    选择PostgreSQL。

    数据库版本

    当前支持RDS PostgreSQL 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. 重新应用参数模板到目标实例,具体操作请参见应用参数模板

  • 本页导读 (1)
文档反馈