参数表达式支持哪些类别,如何使用_云原生数据库 PolarDB(PolarDB)-阿里云帮助中心

PolarDB新增支持将集群规格相关的参数设置为表达式的形式，当集群规格发生变更时，使用表达式设置的参数值会适应规格的变更而自动变化，使集群始终保持最优或最稳定的状态。

注意事项

参数值为数值类型的参数才支持使用参数表达式，参数值为字符类型的参数不支持。
例如innodb_sort_buffer_size（取值范围为65536~67108864）参数值可以使用表达式设置为{DBNodeClassMemory*3/4}，但loose_recycle_bin（取值为ON或OFF）的参数值不支持使用表达式。
某些参数值也是数值类型，但该参数值并不具备数字含义，例如ssl参数的取值为0或1，其中0表示SSL加密关闭，1表示SSL加密开启，此时不建议使用表达式的方式设置该参数。
集群变配后，使用了参数表达式设置的参数值可能会超出该参数允许的取值范围，此时最终取值将以该参数的取值范围为准。
例如，设置了innodb_max_undo_log_size（取值范围为[10485760-107374182400]）参数值为{DBNodeClassMemory*1/2}，那么：
- 当集群规格的内存升配至256 GB及以上时，{DBNodeClassMemory*1/2}的计算值（256 GB×1/2=128 GB=137438953472 Byte）大于107374182400，此时innodb_max_undo_log_size最终取值即为107374182400。
- 当集群规格的内存在256 GB以下时，{DBNodeClassMemory*1/2}的计算值符合该参数的取值范围，innodb_max_undo_log_size最终取值即为{DBNodeClassMemory*1/2}的计算值。
说明
建议您使用参数表达式设置参数前先确认对应参数的取值范围，并要考虑到集群规格升降导致的参数值变动问题。

参数表达式支持类别

PolarDB参数表达式语法的相关支持详见下表。

支持类别	说明	示例
变量	DBNodeClassIOPS：计算节点规格的IOPS大小，整数型。 DBNodeClassMemory：计算节点规格的内存大小，整数型。默认单位为Byte。 DBNodeClassCPU：计算节点规格的CPU核数，整数型。 DBNodeClassConnections：实例规格的最大连接数，整数型。说明关于计算节点规格列表以及各规格的IOPS、内存、CPU核数以及最大连接数，请参见企业版计算节点规格。	`{DBNodeClassMemory*3/4}`：表示目标参数的取值需等于当前计算节点规格内存的75%。
运算符	表达式语法：使用`{}`包裹。除法运算符（/）：用被除数除以除数，返回整数型商。如果商是小数，则不四舍五入，只取整数部分。语法： `dividend / divisor` 乘法运算符（）：两个乘数相乘，返回整数型积。如果积是小数，则不四舍五入，只取整数部分。语法： `expression expression` 说明被除数、除数和乘数均不支持小数运算。例如支持`{DBNodeClassMemory3/4}`，但不支持`{DBNodeClassMemory0.75}`。	`{DBNodeClassMemory*3/4}`：表示目标参数的取值需等于当前计算节点规格内存的75%。
函数	函数`GREATEST()`：返回整数型或者参数公式列表中最大的值。语法： `GREATEST(argument1, argument2,...argumentn)` 函数`LEAST()`：返回整数型或者参数公式列表中最小的值。语法： `LEAST(argument1, argument2,...argumentn)` 函数`SUM()`：添加指定整数型或者参数公式的值。语法： `SUM(argument1, argument2,...argumentn)`	`LEAST({DBNodeClassMemory*1/2},10485760)`：表示目标参数需选取当前计算节点规格内存的50%和10485760 Byte两个值中的较小值。

使用方法

使用表达式来设置参数值的操作步骤与设置集群参数的步骤一致，具体操作步骤，请参见设置集群参数和节点参数。

您只需在修改当前值时，输入对应的表达式即可。例如您可以将innodb_max_undo_log_size的当前值修改为{DBNodeClassMemory*1/2}。