Modifie les paramètres système dynamiques à l'exécution sans redémarrer la base de données.
Moteurs et versions
L'instruction ALTER SYSTEM s'applique à LindormTable et LindormTSDB.
Cette instruction nécessite Lindorm SQL version 2.6.3.2 ou ultérieure. Pour vérifier votre version de Lindorm SQL, consultez le Guide des versions SQL.
Syntaxe
ALTER SYSTEM SET configuration_identifier = configuration_literalParamètres
| Paramètre | Description |
|---|---|
configuration_identifier |
Nom du paramètre de configuration dynamique. Doit être un identifiant SQL valide. Pour la liste des paramètres pris en charge, consultez les Éléments de configuration pris en charge. |
configuration_literal |
Valeur du paramètre de configuration dynamique. Doit être une constante SQL valide. Types acceptés : BIGINT, DOUBLE, BOOLEAN ou VARCHAR. |
Éléments de configuration pris en charge
Paramètres LindormTable
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
FILE_FORMAT_VERSION |
INTEGER | 2 | Version des fichiers de données LindormTable. Définissez la valeur sur 5 pour résoudre l'erreur Cell Tag is not supported since ldFileVersion is too small=2. |
SLOW_QUERY_RECORD_ENABLE |
BOOLEAN | FALSE | Active la vue des requêtes lentes. Une fois activée, les requêtes dépassant le seuil SLOW_QUERY_TIME_MS sont enregistrées dans lindorm._slow_query_. Utile pour l'exploitation, la maintenance et le dépannage. Valeurs valides : TRUE, FALSE. |
SLOW_QUERY_TIME_MS |
INTEGER | 10000 | Seuil des requêtes lentes en millisecondes. Les requêtes dont la durée d'exécution dépasse cette valeur peuvent être enregistrées dans lindorm_slow_query. Après la mise à jour de cette valeur, les requêtes envoyées au serveur Lindorm peuvent être enregistrées dans la vue des requêtes lentes selon le nouveau seuil. |
MAX_CONN |
INTEGER | Variable | Nombre maximal de connexions par nœud pour LindormTable. Doit être supérieur à 0. Lorsque la limite est atteinte, les nouvelles connexions sont rejetées avec l'erreur 1040. Nécessite la version 2.7.0.0 ou ultérieure du moteur SQL. |
AUDIT_LEVEL |
INTEGER | 0 | Niveau des journaux d'audit. Valeurs valides : 0 (journaux DDL et DCL), 1 (journaux DDL, DCL et DML), 2 (journaux DDL, DCL et DQL), 3 (journaux DDL, DCL, DML et DQL). |
ERROR_LANG |
VARCHAR | Dépend de la région | Langue des messages d'erreur SQL. Valeurs valides : en (anglais), zh_CN (chinois simplifié). La valeur par défaut dépend de la région où l'instance a été créée. Nécessite la version 2.9.0.0 ou ultérieure du moteur SQL. |
QUERY_MAX_MEM |
BIGINT | 8388608 (8 Mo) | Mémoire maximale qu'une seule requête peut utiliser dans le moteur Lindorm SQL, exprimée en octets. Si une requête atteint cette limite, augmentez la valeur progressivement. Une valeur trop élevée accroît la pression mémoire sur LindormTable et peut affecter la stabilité du système. Nécessite la version 2.9.6.0 ou ultérieure du moteur SQL. |
lindorm.allow.range.delete |
BOOLEAN | FALSE | Active la suppression par lot. Lorsqu'elle est activée, les suppressions importantes peuvent expirer ; utilisez un HINT pour définir un délai d'expiration plus long. Les suppressions importantes génèrent également des marqueurs de suppression, ce qui peut affecter les performances des requêtes. Nécessite la version 2.9.1.0 ou ultérieure du moteur SQL. |
lindorm.indexed.non.primary.key.columns.max |
INTEGER | 3 | Nombre maximal de colonnes hors clé primaire pouvant servir de colonnes de clé d'index. Une valeur trop élevée allonge la clé de ligne de la table d'index, ce qui peut affecter les performances des requêtes. Nécessite la version 2.9.6.0 ou ultérieure du moteur SQL. |
lindorm.max.index.number |
INTEGER | 5 | Nombre maximal d'index secondaires autorisés. Un nombre excessif d'index secondaires peut réduire les performances en écriture et augmenter l'utilisation du disque. Nécessite la version 2.9.6.0 ou ultérieure du moteur SQL. |
lindorm.schema.column.nonpklength.max |
INTEGER | 2097152 (2 Mo) | Taille maximale des données qu'une seule colonne hors clé primaire peut stocker, exprimée en octets. Il s'agit d'un paramètre au niveau de la table. Des valeurs élevées pour les lectures et écritures volumineuses de paires clé-valeur peuvent provoquer des variations du garbage collection (GC). Nécessite la version 2.9.1.0 ou ultérieure du moteur SQL. |
SYSTEM_TIME_ZONE |
STRING | UTC+8 | Fuseau horaire par défaut de l'instance de base de données. |
Limites de connexion pour MAX_CONN
Le nombre maximal de connexions par nœud par défaut dépend de la version du moteur SQL :
Version du moteur SQL antérieure à 2.7.0.0 : 1000
Version du moteur SQL 2.7.0.0 et ultérieure : 4000
Vérifiez l'utilisation des connexions de votre application avant d'augmenter cette limite.
Paramètres LindormTSDB
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
USER_AUTH |
BOOLEAN | FALSE | Active l'authentification des utilisateurs et la vérification des permissions pour LindormTSDB. Lorsqu'elle est définie sur TRUE, toutes les connexions nécessitent un nom d'utilisateur et un mot de passe, et LindormTSDB vérifie les permissions pour chaque instruction SQL. |
Avant d'activer USER_AUTH, planifiez soigneusement et évaluez pleinement l'impact. Après l'activation, toutes les connexions doivent inclure les identifiants utilisateur, y compris la connexion actuelle qui exécute l'instruction ALTER SYSTEM. Certains accès métier existants peuvent échouer après l'activation de cette fonctionnalité.
Exemples
Définir la version du format de fichier LindormTable
Définissez la version du fichier de données sur 5 pour résoudre l'erreur Cell Tag is not supported :
ALTER SYSTEM SET FILE_FORMAT_VERSION = 5;Activer l'enregistrement des requêtes lentes
Activez la vue des requêtes lentes et définissez le seuil d'enregistrement sur 1 seconde (1000 ms) :
-- Enable slow query recording
ALTER SYSTEM SET SLOW_QUERY_RECORD_ENABLE = TRUE;
-- Set the slow query threshold to 1 second (1000 ms)
ALTER SYSTEM SET SLOW_QUERY_TIME_MS = 1000;Définir le nombre maximal de connexions
Définissez le nombre maximal de connexions par nœud sur 5000 :
ALTER SYSTEM SET MAX_CONN = 5000;Activer ou désactiver l'authentification LindormTSDB
-- Enable authentication
ALTER SYSTEM SET USER_AUTH = TRUE;
-- Disable authentication
ALTER SYSTEM SET USER_AUTH = FALSE;Définir la langue des messages d'erreur SQL
Définissez la langue des messages d'erreur SQL sur le chinois simplifié :
ALTER SYSTEM SET ERROR_LANG = 'zh_CN';Activer la suppression par lot
ALTER SYSTEM SET `lindorm.allow.range.delete` = TRUE;Définir le nombre maximal de colonnes de clé d'index
Définissez le nombre maximal de colonnes hors clé primaire utilisables comme colonnes de clé d'index sur 5 :
ALTER SYSTEM SET `lindorm.indexed.non.primary.key.columns.max` = 5;Définir le nombre maximal d'index secondaires
Définissez le nombre maximal d'index secondaires sur 5 :
ALTER SYSTEM SET `lindorm.max.index.number` = 5;Définir la taille maximale des données pour une colonne hors clé primaire
Définissez la taille maximale des données pour une seule colonne hors clé primaire sur 3 670 016 octets (3,5 Mo) :
ALTER TABLE tableName SET 'MAX_NONPK_LEN' = '3670016';Vérifier la configuration
Utilisez SHOW SYSTEM VARIABLES pour confirmer l'application d'un paramètre :
SHOW SYSTEM VARIABLES LIKE configuration_identifier;Remplacez configuration_identifier par le nom du paramètre, par exemple :
SHOW SYSTEM VARIABLES LIKE 'SLOW_QUERY_TIME_MS';Les paramètres qui n'ont pas été explicitement définis à l'aide de ALTER SYSTEM SET n'apparaissent pas dans la sortie de SHOW SYSTEM VARIABLES.