通过ALTER SYSTEM语法修改系统动态配置参数 - 云原生多模数据库 Lindorm

修改系统动态配置参数。

引擎与版本

ALTER SYSTEM语句适用于宽表引擎和时序引擎。

重要

要求Lindorm SQL为2.6.3.2以上版本。如何查看Lindorm SQL的版本，请参见SQL版本说明。

语法

alter_system_statement ::= ALTER SYSTEM SET configuration_identifier = configuration_literal

使用说明

参数

描述

configuration_identifier

动态配置参数名。必须是一个SQL标识符。已支持的配置项列表，请参见已支持的配置项列表。

configuration_literal

动态配置参数值。必须是一个SQL常量。根据动态配置参数名不同，SQL常量取值如下：

BIGINT类型常量。
DOUBLE类型常量。
BOOLEAN类型常量。
VARCHAR类型常量。

已支持的配置项列表

配置项名称	数据类型	适用引擎	描述
FILE_FORMAT_VERSION	Integer	宽表引擎	设置宽表引擎中数据文件的版本。宽表引擎数据文件的默认版本是2。说明如果您在使用过程中遇到报错`Cell Tag is not supported since ldFileVersion is too small=2`，可以将文件版本号修改为5来解决该问题。
SLOW_QUERY_RECORD_ENABLE	Boolean	宽表引擎	设置是否启用宽表引擎中的慢查询系统视图，当该配置启用后，查询执行时间超过一定阈值时，相关的查询信息就会被记录在视图`lindorm._slow_query_`中，方便运维巡检与问题排查。取值如下： TRUE FALSE（默认值）
SLOW_QUERY_TIME_MS	Integer	宽表引擎	设置记录到`lindorm_slow_query`中的慢查询耗时阈值，单位：毫秒（ms）。默认值：10000毫秒（10秒）。说明当该值被修改且修改成功后，发送到Lindorm服务端的查询才有可能基于新阈值被记录到慢查询视图中。
MAX_CONN	Integer	宽表引擎	设置宽表引擎的最大连接数。取值必须大于0。重要要求宽表引擎为2.6.6及以上版本。如果您的宽表引擎无法通过控制台升级至2.6.6及以上版本，请联系Lindorm技术支持（钉钉号：s0s3eg3）。
USER_AUTH	Boolean	时序引擎	设置时序引擎用户认证与鉴权功能的开关。取值如下： TRUE：启用用户认证与鉴权。任何与时序引擎的连接都需要带上用户名和密码，时序引擎会对用户进行认证，并对该连接发起的SQL中的数据对象进行鉴权。 FALSE（默认值）：关闭用户认证与鉴权。与时序引擎的连接无需带上用户名和密码。重要时序引擎一旦开启用户认证和权限校验，后续的所有访问都必须添加用户信息，否则将可能出现鉴权失败（包括当前执行`ALTER SYSTEM`语句启用用户认证和权限校验的连接）。因此，该功能开启后，已有的部分业务访问可能会失败。所以在开启该功能前，建议仔细规划并充分评估影响。

示例

将宽表引擎的数据文件版本号设置为5。
```
ALTER SYSTEM SET FILE_FORMAT_VERSION = 5;
```
结果验证
您可以通过SHOW SYSTEM VARIABLES LIKE 'FILE_FORMAT_VERSION';语句查看是否设置成功。
打开宽表引擎中记录慢查询的视图，并设置慢查询记录的阈值。
```
-- 启用慢查询记录
ALTER SYSTEM SET SLOW_QUERY_RECORD_ENABLE = TRUE; 

-- 设置慢查询阈值为1秒（即1000ms）
ALTER SYSTEM SET SLOW_QUERY_TIME_MS = 1000; 
```
结果验证
您可以通过SHOW SYSTEM VARIABLES LIKE 'SLOW_QUERY_TIME_MS';语句查看是否设置成功。
将宽表引擎的最大连接数设置为5,000。
```
ALTER SYSTEM SET MAX_CONN = 5000;
```
结果验证
您可以通过SHOW SYSTEM VARIABLES LIKE 'MAX_CONN';语句查看是否设置成功。

开启或关闭时序引擎的鉴权功能。

-- 开启鉴权
ALTER SYSTEM SET USER_AUTH=TRUE; 

-- 关闭鉴权
ALTER SYSTEM SET USER_AUTH=FALSE;