使用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。重要要求SQL引擎版本為2.7.0.0及以上版本。單節點存在預設最大串連數限制，如果串連數已達該預設值，建立串連時會被拒絕且報錯1040。建議優先重新審視業務代碼中對於串連的使用方式，您也可以通過SQL語句修改寬表最大串連數。預設的單節點串連數上限如下： SQL引擎版本在2.7.0.0之前： 1000。 SQL引擎版本為2.7.0.0及以上： 4000。
AUDIT_LEVEL	INTEGER	寬表引擎	設定寬表引擎的審計日誌的層級。取值如下： 0（預設值）：輸出DDL和DCL日誌。 1：輸出DDL、DCL、DML日誌。 2：輸出DDL、DCL、DQL日誌。 3：輸出DDL、DCL、DML、DQL日誌。
ERROR_LANG	VARCHAR	寬表引擎	設定Lindorm SQL異常報錯訊息文本的語言。目前支援以下兩種語言： `en`：英文。 `zh_CN`：簡體中文。重要要求SQL引擎版本為2.9.0.0及以上版本。 SQL引擎異常訊息文本的預設語言種類與執行個體開啟時所屬的地區相關。
USER_AUTH	BOOLEAN	時序引擎	設定時序引擎使用者認證與鑒權功能的開關。取值如下： TRUE：啟用使用者認證與鑒權。任何與時序引擎的串連都需要帶上使用者名稱和密碼，時序引擎會對使用者進行認證，並對該串連發起的SQL中的資料對象進行鑒權。 FALSE（預設值）：關閉使用者認證與鑒權。與時序引擎的串連無需帶上使用者名稱和密碼。重要時序引擎一旦開啟使用者認證和許可權校正，後續的所有訪問都必須添加使用者資訊，否則可能出現鑒權失敗（包括當前執行`ALTER SYSTEM`語句啟用使用者認證和許可權校正的串連）。因此，該功能開啟後，已有的部分業務訪問可能會失敗。所以在開啟該功能前，建議仔細規劃並充分評估影響。
QUERY_MAX_MEM	BIGINT	寬表引擎	Lindorm SQL 引擎中對於單個查詢所允許消耗的記憶體上限。預設值是8388608 位元組（8MB）。重要要求SQL引擎版本為 2.9.6.0 及以上版本。當查詢觸發記憶體上限時，可適當調大該配置值（建議按翻倍方式逐步調整），但需注意：該參數控制每個查詢的記憶體上限，設定過大會導致寬表引擎記憶體壓力激增，可能引發系統穩定性風險。
lindorm.allow.range.delete	BOOLEAN	寬表引擎	是否允許大量刪除。取值如下： TRUE FALSE（預設值）重要要求SQL引擎版本為2.9.1.0及以上版本。開啟批量查詢，如果刪除大量資料，請求可能會逾時，需要通過 HINT設定逾時時間。另外大量刪除資料會產生大量deletemarker，會對查詢效能產生一定影響。
lindorm.indexed.non.primary.key.columns.max	INTEGER	寬表引擎	允許非主鍵列作為索引列主鍵的最大數量，預設值為3。重要要求SQL引擎版本為2.9.6.0及以上版本。若索引表主鍵過多，可能會造成索引表 rowkey 太長，影響查詢效能。
lindorm.max.index.number	INTEGER	寬表引擎	允許建立的二級索引的最大數量，預設值為5。重要要求SQL引擎版本為2.9.6.0及以上版本。若二級索引過多，可能會引起寫入效能下降和磁碟使用量增多。
lindorm.schema.column.nonpklength.max	INTEGER	寬表引擎	單個非主鍵列允許儲存的資料值上限。針對錶層級配置，單位位元組。預設值為2,097,152位元組（2M）。重要要求SQL引擎版本為2.9.1.0及以上版本。大量的大 KV 讀寫容易引起 GC 抖動。
SYSTEM_TIME_ZONE	STRING	寬表引擎	用於指定整個資料庫系統執行個體的預設時區，預設值為UTC+8。

樣本

修改寬表檔案版本號碼

將寬表引擎的資料檔案版本號碼設定為5。

ALTER SYSTEM SET FILE_FORMAT_VERSION = 5;

設定寬錶慢查詢記錄的閾值

開啟寬表引擎中記錄慢查詢的視圖，並設定慢查詢記錄的閾值。

-- 啟用慢查詢記錄
ALTER SYSTEM SET SLOW_QUERY_RECORD_ENABLE = TRUE; 

-- 設定慢查詢閾值為1秒（即1000ms）
ALTER SYSTEM SET SLOW_QUERY_TIME_MS = 1000;

修改寬表最大串連數

將寬表引擎的最大串連數設定為5000。

ALTER SYSTEM SET MAX_CONN = 5000;

開啟或關閉時序引擎的鑒權功能

-- 開啟鑒權
ALTER SYSTEM SET USER_AUTH=TRUE; 

-- 關閉鑒權
ALTER SYSTEM SET USER_AUTH=FALSE;

修改寬表SQL異常訊息文本的語言

將寬表引擎中SQL異常訊息文本的語言設定為簡體中文。

ALTER SYSTEM SET ERROR_LANG = 'zh_CN';

設定是否允許大量刪除

修改是否允許大量刪除，預設值為FALSE。

ALTER SYSTEM SET `lindorm.allow.range.delete`=TRUE;

修改非主鍵列作為索引列主鍵的數量

將非主鍵列作為索引列主鍵的數量設定為5。

ALTER SYSTEM SET `lindorm.indexed.non.primary.key.columns.max`= 5;

修改二級索引數量

將二級索引的數量設定為5。

ALTER SYSTEM SET `lindorm.max.index.number`= 5;

修改單個非主鍵列允許儲存的資料量

將單個非主鍵列允許儲存的資料設定為3,670,016位元組（3.5M）。

ALTER TABLE tableName SET 'MAX_NONPK_LEN'='3670016';

結果驗證

您可以通過SHOW SYSTEM VARIABLES LIKE configuration_identifier;語句查看是否設定成功，configuration_identifier為對應參數名。

說明

如果未使用 ALTER SYSTEM SET 命令設定過某個參數，SHOW SYSTEM VARIABLES 將不會反映出該參數的動態配置。