PolarDB集群创建完成后，您可以通过控制台来修改集群参数和节点参数，并且可以将修改后的集群参数导出为模板。同时，同一地域的集群可以通过应用模板功能快速修改集群参数。本文介绍修改集群参数和节点参数，以及将修改后的集群参数导出为模板并应用模板的方法。

背景信息

PolarDB提供节点参数可配置功能，您可以根据实际需求对任意节点参数进行配置。
  • 集群中新增的节点默认使用集群参数。
  • 当主节点发生故障，主节点切换为只读节点后：
    • 原主节点角色变为只读节点，原主节点参数保持不变。
    • 原只读节点角色变为主节点，原只读节点参数保持不变。
  • 当主可用区故障时，备可用区的节点切换为主节点后，备可用区的节点将使用集群参数。

注意事项

当前仅支持修改：
  • PolarDB MySQL版 5.6和5.7版本的节点参数innodb_buffer_pool_size 。
  • PolarDB MySQL版 8.0版本的节点参数innodb_buffer_pool_size 、loose_oss_outfile_buffer_size、loose_max_oss_outfile_threads、loose_csv_oss_buff_size。
其余节点参数如有修改需求，请前往配额中心，在配额名称设置集群参数和节点参数的操作列，单击申请，并填写需要设置和修改的集群ID和对应参数。

修改参数值

修改集群参数，对该集群下的所有节点生效。修改节点参数，只对当前节点生效。此处以修改集群参数为例。

  1. 登录PolarDB控制台。
  2. 在控制台左上角，选择集群所在地域。
  3. 找到目标集群，单击集群ID。
  4. 在左侧导航栏，选择配置与管理 > 参数配置。
  5. 在左上角的下拉列表中选择集群。若修改节点参数，选择您需要修改参数的节点。
    选择节点
  6. 在页面左上方，单击修改参数。
  7. 找到目标参数，并输入新的参数值。
    填写参数
    说明
    • 请输入目标参数右侧修改范围列规定的参数值，否则当您提交修改时会出现错误提示。
    • 您可以单击目标参数名称后的参数图标图标查看参数的详细信息。
  8. 单击左上角的提交修改。
  9. 在保存改动页选择需要应用到的节点，单击确定。
    保存改动
    说明
    • 对于是否重启栏显示为是的参数，修改完成后，需要重启集群内的所有节点，新的参数值才会生效。重启前，请提前做好业务安排，谨慎操作。
    • 若您的PolarDB MySQL版集群版本为8.0，您还可以修改参数innodb_fast_startup的值为ON来加速重启。

应用参数模板

参数配置完成后，您可以进行如下操作：
  • 将集群的参数配置导出为参数模板。
    1. 登录PolarDB控制台。
    2. 在控制台左上角，选择目标集群所在地域。
    3. 找到目标集群，单击集群ID。
    4. 在左侧导航栏中，单击配置与管理 > 参数配置。
    5. 单击导出为模板。
      说明
      • 如果您需要修改当前参数列表中的参数信息，请您在完成修改后，单击导出为模板。
      • 导出为模板生成的集群参数由您手动修改的参数和集群在运行过程中自动修改的参数组成。
    6. 在弹出的应用模板对话框中，设置以下参数。
      参数说明
      模板名称模板的名称。名称需要满足以下规则：
      • 由英文、数字、和下划线（_）组成，以字母开头，不能包含中文。
      • 长度为8~64个字符。
      描述备注该模板的相关信息，便于后续管理。长度为0~200个字符。
    7. 单击确定。
  • 将参数模板应用至目标集群。
    1. 单击应用模板。
    2. 在弹出的应用模板对话框中，选择需要使用的参数模板名称，并单击确定。
      说明
      • 您可以查看该参数模板的参数个数、是否需要重启和更新时间。
      • 如果参数模板中存在需要重启集群的参数，建议您在业务低峰期操作，并确保应用程序具有重连机制。
      • 您也可以通过在参数模板页面，将参数模板应用至集群，详情请参见应用参数模板。

对比节点参数

由于当前不同节点的参数可以不同，您可以通过参数对比功能，对比不同节点的参数配置情况。

  1. 登录PolarDB控制台。
  2. 在控制台左上角，选择集群所在地域。
  3. 找到目标集群，单击集群ID。
  4. 在左侧导航栏中，选择配置与管理 > 参数配置。
  5. 在页面左上方，单击参数对比。
    对比参数
  6. 选择需要对比的节点，查看节点对比结果。

相关API

API描述
DescribeDBClusterParameters查看集群的参数。
ModifyDBClusterParameters修改集群的参数。
ModifyDBClusterAndNodesParameters修改集群参数并应用到指定节点。
ModifyDBNodesParameters修改单个节点并选择应用到指定节点。
DescribeParameterTemplates查询默认参数列表。