文档

ALTER SYSTEM

更新时间:

修改系统动态配置参数。

引擎与版本

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;