通過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支援人員（DingTalk號：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;