在配置PolarDB集群时，如果多个集群中包含一个或多个参数的配置相同，您可以使用参数模板功能，对参数进行集中管理，并快速应用至集群，以提升参数管理效率和集群配置效率。

前提条件

集群版本如下：
  • MySQL 8.0
  • MySQL 5.7
  • MySQL 5.6

创建参数模板

  1. 登录PolarDB控制台。
  2. 在控制台左上角，选择集群所在地域。
  3. 在左侧导航栏中，选择参数模板。
  4. 在参数模板页面，单击创建参数模板。
  5. 设置以下参数。
    参数 说明
    模板名称 模板的名称。名称需要满足以下规则：
    • 由英文、数字和下划线（_）组成，以字母开头，不能包含中文。
    • 长度为8~64个字符。
    数据库引擎 数据库引擎类型，当前仅支持MySQL。
    数据库版本 数据库引擎版本，取值范围如下：
    • 8.0
    • 5.7
    • 5.6
    描述 备注该模板的相关信息，便于后续管理。长度为0~200个字符。
    添加配置 单击添加配置会增加一行参数供您选择参数名，并通过参考描述和可修改参数值设置配置值。您还可以看到是否重启集群、参数默认值等信息。
    说明
    • 需要配置下一个参数，请再次单击添加配置。
    • 需要删除某个参数，请单击该参数右侧的删除。
    导入 单击导入，输入参数及参数值。输入格式需要按照key=value格式输入，多组数据之间请换行，例如：
    wait_timeout=60
thread_stack=262144
  6. 单击确认创建。

应用参数模板

说明
  • 如果参数模板中存在需要重启集群的参数，建议您在业务低峰期操作，并确保应用程序具有重连机制。
  • 参数模板创建后，您可以通过以下两种方法将参数模板应用至集群：
    • 在PolarDB集群页面应用模板，详情请参见应用模板。
    • 直接将模板应用至集群，详情见以下操作步骤。
  1. 登录PolarDB控制台。
  2. 在控制台左上角，选择集群所在地域。
  3. 在左侧导航栏中，选择参数模板。
  4. 在参数模板页面，单击自定义参数模板页签。
  5. 在自定义参数模板列表中，单击目标模板所在行操作列的应用到实例。
  6. 在应用到实例页面，选择需要应用参数模板的集群，单击移动移动到右侧，同时您可以通过参数对比查看参数模板中参数配置值与集群中参数配置值的差异。
    说明 应用参数模板到多个集群上时，请注意以下问题：
    • 请确认参数是否适用这些集群，请谨慎操作。
    • 单次操作只能将参数模板应用到10个集群。如果需要将参数模板应用至10个以上的集群，您可以分批操作。
    • 参数模板所在地域需与需要应用该模板的集群所在地域一致。如果不在同一地域，请您在集群所在地域创建参数模板，然后应用。
    应用到集群
  7. 单击确定。

复制参数模板

  1. 登录PolarDB控制台。
  2. 在控制台左上角，选择集群所在地域。
  3. 在左侧导航栏中，选择参数模板。
  4. 在参数模板页面，单击自定义参数模板页签。
  5. 在自定义参数模板列表中，单击目标模板所在行操作列的克隆。
  6. 设置以下参数。
    参数 说明
    模板名称 模板的名称，默认为原参数模板名称_clone，您也可以重新命名。名称需满足以下规则：
    • 由英文、数字、和下划线（_）组成，以字母开头，不能包含中文。
    • 长度为8~64个字符。
    数据库引擎 当前仅支持MySQL。
    数据库版本 当前支持MySQL 5.6、5.7和8.0，默认为原参数模板选择的版本，您也可以根据需要重新选择版本。
    描述 备注该模板的相关信息，便于后续管理。长度为0~200个字符。
    添加配置 默认为原参数模板中的参数配置项，您也可以根据需要重新进行配置。
    说明
    • 如果您需要添加某个参数，请单击添加配置。
    • 如果您需要修改某个参数的配置值，请在该参数右侧的配置值输入框中重新输入。
    • 如果您需要删除某个参数，请单击该参数右侧的删除。
    导入 单击导入，输入参数及参数值。输入格式需要按照key=value格式输入，多组数据之间请换行，例如：
    wait_timeout=60
thread_stack=262144
  7. 单击确认创建。

删除参数模板

  1. 登录PolarDB控制台。
  2. 在控制台左上角，选择集群所在地域。
  3. 在左侧导航栏中，选择参数模板。
  4. 在参数模板页面，单击自定义参数模板页签。
  5. 在自定义参数模板列表中，单击目标模板所在行操作列的删除。
  6. 单击确定。
说明 如果需要同时删除多个参数模板，请选中目标参数模板，然后单击批量删除即可。

查看参数模板差异

  1. 登录PolarDB控制台。
  2. 在控制台左上角，选择集群所在地域。
  3. 在左侧导航栏中，选择参数模板。
  4. 在参数模板页面，单击自定义参数模板页签。
  5. 在自定义参数模板列表中，选择需要对比的参数模板，单击比较差异。
  6. 在比较差异页面，查看各参数模板中参数的差异。

相关API

API 描述
CreateParameterGroup 创建参数模板。
DescribeParameterGroups 查询参数模板列表。
DescribeParameterGroup 查询参数模板详情。
ModifyDBClusterParameters 修改或应用参数模板。
DeleteParameterGroup 删除参数模板。