modify dynamic system parameters using the alter system syntax - Lindorm: Central de Documentação do Alibaba Cloud

Mecanismos e versões

A instrução ALTER SYSTEM aplica-se ao LindormTable e ao LindormTSDB.

Importante

Esta instrução exige a versão 2.6.3.2 ou posterior do Lindorm SQL. Para verifique sua versão do Lindorm SQL, consulte Guia de Versões do SQL.

Sintaxe

ALTER SYSTEM SET configuration_identifier = configuration_literal

Parâmetros

Parâmetro	Descrição
`configuration_identifier`	Nome do parâmetro de configuração dinâmica. Deve ser um identificador SQL válido. Para os parâmetros compatíveis, consulte Itens de configuração compatíveis.
`configuration_literal`	Valor do parâmetro de configuração dinâmica. Deve ser uma constante SQL válida. Tipos aceitos: BIGINT, DOUBLE, BOOLEAN ou VARCHAR.

Itens de configuração compatíveis

Parâmetros do LindormTable

Parâmetro	Tipo	Padrão	Descrição
`FILE_FORMAT_VERSION`	INTEGER	2	Versão dos arquivos de dados do LindormTable. Defina como `5` para resolver o erro `Cell Tag is not supported since ldFileVersion is too small=2`.
`SLOW_QUERY_RECORD_ENABLE`	BOOLEAN	FALSE	Ativa a visualize de consultas lentas. Quando ativado, as consultas que excedem o limiar de `SLOW_QUERY_TIME_MS` são registradas em `lindorm._slow_query_`. Útil para operações e manutenção (O&M) e solução de problemas. Valores válidos: `TRUE`, `FALSE`.
`SLOW_QUERY_TIME_MS`	INTEGER	10000	Limiar de consulta lenta em milissegundos. Consultas com duração superior a este valor podem ser registradas em `lindorm_slow_query`. Após atualize este valor, as consultas enviadas ao servidor Lindorm podem ser registradas na visualize de consultas lentas com base no novo limiar.
`MAX_CONN`	INTEGER	Variável	Número máximo de conexões por nó para o LindormTable. Deve ser maior que 0. Ao atingir o limite, novas conexões são rejeitadas com o erro 1040. Requer a versão 2.7.0.0 ou posterior do mecanismo SQL.
`AUDIT_LEVEL`	INTEGER	0	Nível de log de auditoria. Valores válidos: `0` (logs DDL e DCL), `1` (logs DDL, DCL e DML), `2` (logs DDL, DCL e DQL), `3` (logs DDL, DCL, DML e DQL).
`ERROR_LANG`	VARCHAR	Dependente da região	Idioma das mensagens de erro SQL. Valores válidos: `en` (Inglês), `zh_CN` (Chinês Simplificado). O padrão depende da região onde a instância foi criada. Requer a versão 2.9.0.0 ou posterior do mecanismo SQL.
`QUERY_MAX_MEM`	BIGINT	8388608 (8 MB)	Memória máxima que uma única consulta pode utilizar no mecanismo Lindorm SQL, em bytes. Se uma consulta atingir esse limite, aumente o valor incrementalmente. Definir um valor muito alto aumenta a pressão de memória no LindormTable e pode afetar a estabilidade do sistema. Requer a versão 2.9.6.0 ou posterior do mecanismo SQL.
`lindorm.allow.range.delete`	BOOLEAN	FALSE	Habilita a exclua em lote. Quando ativado, grandes exclusões podem expirar — use HINT para definir um tempo limite maior. Grandes exclusões também geram marcadores de exclusão, o que pode afetar o desempenho da consulta. Requer a versão 2.9.1.0 ou posterior do mecanismo SQL.
`lindorm.indexed.non.primary.key.columns.max`	INTEGER	3	Quantidade máxima de colunas fora da chave primária utilizáveis como colunas de chave de índice. Um valor muito alto torna a chave de linha da tabela de índice mais longa, podendo impactar o desempenho das consultas. Requer a versão 2.9.6.0 ou posterior do mecanismo SQL.
`lindorm.max.index.number`	INTEGER	5	Limite de índices secundários permitidos. O excesso de índices secundários pode reduzir o desempenho de gravação e aumentar o uso de disco. Requer a versão 2.9.6.0 ou posterior do mecanismo SQL.
`lindorm.schema.column.nonpklength.max`	INTEGER	2097152 (2 MB)	Tamanho máximo de dados que uma única coluna fora da chave primária pode armazenar, em bytes. Esta é uma configuração no nível da tabela. Valores elevados para leituras e gravações de pares chave-valor grandes podem causar oscilações na coleta de lixo (GC). Requer a versão 2.9.1.0 ou posterior do mecanismo SQL.
`SYSTEM_TIME_ZONE`	STRING	UTC+8	Fuso horário padrão da instância de banco de dados.

Limites de conexão para MAX_CONN

O número máximo padrão de conexões por nó varia conforme a versão do mecanismo SQL:

Versão do mecanismo SQL anterior à 2.7.0.0: 1000
Versão do mecanismo SQL 2.7.0.0 e posteriores: 4000

Analise o uso de conexões da sua aplicação antes de aumentar este limite.

Parâmetros do LindormTSDB

Parâmetro	Tipo	Padrão	Descrição
`USER_AUTH`	BOOLEAN	FALSE	Ativa a autenticação de usuário e a verificação de permissões para o LindormTSDB. Quando definido como `TRUE`, todas as conexões exigem nome de usuário e senha, e o LindormTSDB verifica as permissões para cada instrução SQL.

Importante

Antes de ative o USER_AUTH, planeje cuidadosamente e avalie totalmente o impacto. Após a ativação, todas as conexões devem incluir credenciais de usuário — inclusive a conexão atual que execute a instrução ALTER SYSTEM. Alguns acessos existentes de negócios podem falhar após a habilitação deste recurso.

Exemplos

Definir a versão do formato de arquivo do LindormTable

Defina a versão do arquivo de dados como 5 para resolver o erro Cell Tag is not supported:

ALTER SYSTEM SET FILE_FORMAT_VERSION = 5;

Ativar o registro de consultas lentas

Ative a visualize de consultas lentas e defina o limiar de registro para 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;

Definir o máximo de conexões

Defina o número máximo de conexões por nó como 5000:

ALTER SYSTEM SET MAX_CONN = 5000;

Ativar ou desativar a autenticação do LindormTSDB

-- Enable authentication
ALTER SYSTEM SET USER_AUTH = TRUE;

-- Disable authentication
ALTER SYSTEM SET USER_AUTH = FALSE;

Definir o idioma das mensagens de erro SQL

Defina o idioma das mensagens de erro SQL como Chinês Simplificado:

ALTER SYSTEM SET ERROR_LANG = 'zh_CN';

Ativar a exclua em lote

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

Definir o máximo de colunas de chave de índice

Defina o número máximo de colunas fora da chave primária utilizáveis como colunas de chave de índice como 5:

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

Definir o número máximo de índices secundários

Defina o número máximo de índices secundários como 5:

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

Definir o tamanho máximo de dados para uma coluna fora da chave primária

Defina o tamanho máximo de dados para uma única coluna fora da chave primária como 3.670.016 bytes (3,5 MB):

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

Verificar a configuração

Use SHOW SYSTEM VARIABLES para confirme se um parâmetro foi aplicado:

SHOW SYSTEM VARIABLES LIKE configuration_identifier;

Substitua configuration_identifier pelo nome do parâmetro, por exemplo:

SHOW SYSTEM VARIABLES LIKE 'SLOW_QUERY_TIME_MS';

Nota

Parâmetros não definidos explicitamente usando ALTER SYSTEM SET não aparecem na saída de SHOW SYSTEM VARIABLES.