modify dynamic system parameters using the alter system syntax - Lindorm

Modifica los parámetros dinámicos del sistema en tiempo de ejecución sin reiniciar la base de datos.

Motores y versiones

La instrucción ALTER SYSTEM aplica a LindormTable y LindormTSDB.

Importante

Esta instrucción requiere Lindorm SQL versión 2.6.3.2 o posterior. Para consultar su versión de Lindorm SQL, consulte SQL Version Guide.

Sintaxis

ALTER SYSTEM SET configuration_identifier = configuration_literal

Parámetros

Parámetro	Descripción
`configuration_identifier`	Nombre del parámetro de configuración dinámica. Debe ser un identificador SQL válido. Para ver los parámetros compatibles, consulte Supported configuration items.
`configuration_literal`	Valor del parámetro de configuración dinámica. Debe ser una constante SQL válida. Tipos aceptados: BIGINT, DOUBLE, BOOLEAN o VARCHAR.

Elementos de configuración compatibles

Parámetros de LindormTable

Parámetro	Tipo	Predeterminado	Descripción
`FILE_FORMAT_VERSION`	INTEGER	2	Versión de los archivos de datos de LindormTable. Establezca este valor en `5` para resolver el error `Cell Tag is not supported since ldFileVersion is too small=2`.
`SLOW_QUERY_RECORD_ENABLE`	BOOLEAN	FALSE	Habilita la vista de consultas lentas. Cuando está habilitada, las consultas que superan el umbral de `SLOW_QUERY_TIME_MS` se registran en `lindorm._slow_query_`. Es útil para tareas de operación y mantenimiento, así como para la resolución de problemas. Valores válidos: `TRUE`, `FALSE`.
`SLOW_QUERY_TIME_MS`	INTEGER	10000	Umbral de consulta lenta en milisegundos. Las consultas que se ejecutan durante más tiempo que este valor pueden registrarse en `lindorm_slow_query`. Después de actualizar este valor, las consultas enviadas al servidor Lindorm podrían registrarse en la vista de consultas lentas según el nuevo umbral.
`MAX_CONN`	INTEGER	Variable	Número máximo de conexiones por nodo para LindormTable. Debe ser mayor que 0. Cuando se alcanza el límite, las nuevas conexiones se rechazan con el error 1040. Requiere la versión 2.7.0.0 o posterior del motor SQL.
`AUDIT_LEVEL`	INTEGER	0	Nivel de registro de auditoría. Valores válidos: `0` (registros DDL y DCL), `1` (registros DDL, DCL y DML), `2` (registros DDL, DCL y DQL), `3` (registros DDL, DCL, DML y DQL).
`ERROR_LANG`	VARCHAR	Dependiente de la región	Idioma de los mensajes de error SQL. Valores válidos: `en` (inglés), `zh_CN` (chino simplificado). El valor predeterminado depende de la región donde se creó la instancia. Requiere la versión 2.9.0.0 o posterior del motor SQL.
`QUERY_MAX_MEM`	BIGINT	8388608 (8 MB)	Memoria máxima que puede utilizar una sola consulta en el motor SQL de Lindorm, en bytes. Si una consulta alcanza este límite, aumente el valor de forma incremental. Un valor demasiado alto incrementa la presión de memoria en LindormTable y puede afectar la estabilidad del sistema. Requiere la versión 2.9.6.0 o posterior del motor SQL.
`lindorm.allow.range.delete`	BOOLEAN	FALSE	Habilita la eliminación por lotes. Cuando está habilitada, las eliminaciones grandes pueden agotar el tiempo de espera; use HINT para establecer un tiempo de espera más largo. Las eliminaciones grandes también generan marcadores de eliminación, lo cual puede afectar el rendimiento de las consultas. Requiere la versión 2.9.1.0 o posterior del motor SQL.
`lindorm.indexed.non.primary.key.columns.max`	INTEGER	3	Número máximo de columnas que no son clave primaria y que pueden usarse como columnas clave de índice. Un valor demasiado alto alarga la clave de fila de la tabla de índices, lo que puede afectar el rendimiento de las consultas. Requiere la versión 2.9.6.0 o posterior del motor SQL.
`lindorm.max.index.number`	INTEGER	5	Número máximo de índices secundarios permitidos. Un exceso de índices secundarios puede reducir el rendimiento de escritura y aumentar el uso de disco. Requiere la versión 2.9.6.0 o posterior del motor SQL.
`lindorm.schema.column.nonpklength.max`	INTEGER	2097152 (2 MB)	Tamaño máximo de datos que puede almacenar una sola columna que no es clave primaria, en bytes. Esta es una configuración a nivel de tabla. Los valores grandes en lecturas y escrituras de pares clave-valor grandes pueden causar inestabilidad en la recolección de basura (GC). Requiere la versión 2.9.1.0 o posterior del motor SQL.
`SYSTEM_TIME_ZONE`	STRING	UTC+8	Zona horaria predeterminada de la instancia de base de datos.

Límites de conexión para MAX_CONN

El número máximo predeterminado de conexiones por nodo depende de la versión del motor SQL:

Versión del motor SQL anterior a la 2.7.0.0: 1000
Versión del motor SQL 2.7.0.0 y posteriores: 4000

Revise el uso de conexiones de su aplicación antes de aumentar este límite.

Parámetros de LindormTSDB

Parámetro	Tipo	Predeterminado	Descripción
`USER_AUTH`	BOOLEAN	FALSE	Habilita la autenticación de usuarios y la verificación de permisos para LindormTSDB. Cuando se establece en `TRUE`, todas las conexiones requieren un nombre de usuario y una contraseña, y LindormTSDB verifica los permisos para cada instrucción SQL.

Importante

Antes de habilitar USER_AUTH, planifique con cuidado y evalúe completamente el impacto. Una vez habilitada esta función, todas las conexiones deben incluir credenciales de usuario, incluida la conexión actual que ejecuta la instrucción ALTER SYSTEM. Es posible que algunos accesos empresariales existentes fallen después de habilitar esta función.

Ejemplos

Establecer la versión del formato de archivo de LindormTable

Establezca la versión del archivo de datos en 5 para resolver el error Cell Tag is not supported:

ALTER SYSTEM SET FILE_FORMAT_VERSION = 5;

Habilitar el registro de consultas lentas

Habilite la vista de consultas lentas y establezca el umbral de registro en 1 segundo (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;

Establecer el número máximo de conexiones

Establezca el número máximo de conexiones por nodo en 5000:

ALTER SYSTEM SET MAX_CONN = 5000;

Habilitar o deshabilitar la autenticación de LindormTSDB

-- Enable authentication
ALTER SYSTEM SET USER_AUTH = TRUE;

-- Disable authentication
ALTER SYSTEM SET USER_AUTH = FALSE;

Establecer el idioma de los mensajes de error SQL

Establezca el idioma de los mensajes de error SQL en chino simplificado:

ALTER SYSTEM SET ERROR_LANG = 'zh_CN';

Habilitar la eliminación por lotes

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

Establecer el número máximo de columnas clave de índice

Establezca en 5 el número máximo de columnas que no son clave primaria y que pueden usarse como columnas clave de índice:

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

Establecer el número máximo de índices secundarios

Establezca el número máximo de índices secundarios en 5:

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

Establecer el tamaño máximo de datos para una columna que no es clave primaria

Establezca el tamaño máximo de datos para una sola columna que no es clave primaria en 3,670,016 bytes (3.5 MB):

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

Comprobar la configuración

Use SHOW SYSTEM VARIABLES para confirmar que se aplicó un parámetro:

SHOW SYSTEM VARIABLES LIKE configuration_identifier;

Reemplace configuration_identifier con el nombre del parámetro; por ejemplo:

SHOW SYSTEM VARIABLES LIKE 'SLOW_QUERY_TIME_MS';

Nota

Los parámetros que no se han establecido explícitamente mediante ALTER SYSTEM SET no aparecen en la salida de SHOW SYSTEM VARIABLES.