设置集群参数和节点参数

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

背景信息

PolarDB提供节点参数可配置功能,您可以根据实际需求对任意节点参数进行配置。

  • 集群中新增的节点默认使用集群参数。

  • 当主节点发生故障,主节点切换为只读节点后:

    • 原主节点角色变为只读节点,原主节点参数保持不变。

    • 原只读节点角色变为主节点,原只读节点参数保持不变。

  • 当主可用区故障时,备可用区的节点切换为主节点后,备可用区的节点将使用集群参数。

注意事项

  • 当前仅支持修改节点的部分参数,具体请以控制台为准。

  • 对于不支持修改的节点参数,如有修改需求,请前往配额中心,在配额名称设置集群参数和节点参数操作列,单击申请,并填写需要设置和修改的集群ID及对应参数。

    配额中心部分可配置节点参数

    配额ID

    描述

    polardb_mysql_gsi

    申请全局二级索引功能试用。更多信息,请参见全局二级索引(GSI)

    polardb_m_new_feature_white_list

    申请超级计算集群SCC(Super Computing Cluster)功能试用。更多信息,请参见SCC服务

    polardb_mysql_multi_az

    申请集群增强版试用。更多信息,请参见三可用区

    重要

    集群增强版仅支持PolarDB MySQL版5.7内核版本。

    polardb_mysql_calculate_limit

    申请PolarDB MySQL版 100TB特殊存储规格上限。

    polardb_mysql_gdn_region

    全球数据库网络(Global Database Network,简称GDN)是由分布在同一个国家内多个地域的多个PolarDB集群组成的网络。更多信息,请参见全球数据库(GDN)

    polardb_mysql_parameters

    PolarDB MySQL版集群创建完成后,您可以通过控制台来修改集群参数和节点参数,并且可以将修改后的集群参数导出为模板,同一地域的集群可以通过应用模板功能快速修改集群参数。

    说明

    如下为修改参数限制:

    • PolarDB MySQL版5.6和5.7版本的节点参数innodb_buffer_pool_size

    • PolarDB MySQL版8.0版本的节点参数innodb_buffer_pool_sizeloose_oss_outfile_buffer_sizeloose_max_oss_outfile_threadsloose_csv_oss_buff_size

    polardb_mysql_sql_log_bin

    用于控制是否开启会话(Session)级别的Binlog功能。默认情况下,该参数处于关闭状态。

    polardb_mysql_hotspot

    修改参数hotspot_for_autocommithotspot_update_max_wait_timehotspot_lock_type。更多信息,请参见热点行优化

    polardb_M_upgrd_major_version

    提交PolarDB MySQL版在进行大版本升级过程中遇到的问题,比如源表和目标表创建类型不同等,需要提供升级中的问题和集群ID。更多信息,请参见大版本升级常见问题

    polardb_mysql_pddl_for_pk

    用于控制是否开启并行创建主键功能。更多信息,请参见并行DDL

    polardb_mysql_hybrid_partition

    用于控制是否开启混合分区功能。更多信息,请参见创建混合分区

    polardb_delete_oss_data/polardb_delete_oss_data

    用于控制是否开启PolarDB MySQL版 OSS冷数据删除功能。目前仅针对删除CSV和ORC格式的冷数据需要该配额,如需要删除IBD格式的冷数据请直接执行:CALL dbms_oss.delete_table_file('database_name', 'table_name');。更多信息,请参见手动归档冷数据

    polardb_mysql_xengine_partition

    用于控制是否开启X-Engine分区表功能。更多信息,请参见高压缩引擎(X-Engine)分区表

    polardb_mysql_iac_56

    使用传统方法执行加列操作时,需要重建整个表数据,占用大量系统资源。PolarDB MySQL版支持秒级加字段(Instant add column)功能,在加列操作时只需变更表定义信息,无需修改已有数据,帮助您快速完成对任意大小表的加列操作。更多信息,请参见秒级加字段

    polardb_mysql_uci/polardb_mysql_uci

    PolarDB MySQL版支持分区表主键不包含分区键(UNIQUE CHECK IGNORE, 简称UCI)。具体信息,请参见UCI

    说明

    如果您在配置过程中有疑问或需要咨询其他未在配额中心的参数,请联系我们处理。

修改参数值

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

  1. 登录PolarDB控制台

  2. 在左上角,选择集群所在地域。

  3. 找到目标集群,单击集群ID。

  4. 在左侧导航栏,选择配置与管理 > 参数配置

  5. 若您要修改集群的参数,在左上角的下拉列表中选择集群。

    若您要修改节点的参数,在左上角的下拉列表中选择您需要修改参数的节点。

    选择节点

  6. 在页面左上方,单击修改参数

  7. 找到目标参数,并输入新的参数值。

    填写参数

    说明
    • 请输入目标参数右侧修改范围列规定的参数值,否则当您提交修改时会出现错误提示。

    • 您可以单击目标参数名称后的参数图标图标查看参数的详细信息。

    • 在控制台设置参数时,“loose_”只是用来区分参数的一种前缀。例如,"loose_rds_audit_log_event_buffer_size" 和 "rds_audit_log_event_buffer_size" 实际上是同一个参数。

  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

查询默认参数列表。