Exibir propriedades do sistema - Lindorm: Central de Documentação do Alibaba Cloud

Utilize SHOW VARIABLES para inspecionar o valor atual de atributos do sistema ou de tabela. Execute este comando após CREATE TABLE ou ALTER TABLE para confirmar se as alterações foram aplicadas, ou para verificar se configurações no nível do sistema, como log de consultas lentas ou autenticação, estão ativas.

Pré-requisitos

Antes de começar, certifique-se de que:

A versão do Lindorm SQL seja 2.6.3.2 ou posterior. Para verificar sua versão, consulte Versões do SQL
A versão do mecanismo atenda ao requisito mínimo dos recursos que você deseja utilizar. Consulte Mecanismos e versões aplicáveis

Mecanismos e versões aplicáveis

Mecanismo	Versão mínima	Observações
LindormTable	2.6.2	O escopo `TABLE` requer LindormTable 2.6.3+ e Lindorm SQL 2.6.6+
LindormTSDB	3.4.35	Apenas o escopo `SYSTEM` é suportado

Para visualizar ou atualizar a versão do seu mecanismo, consulte Notas de versão do LindormTable, Notas de versão do LindormTSDB e Atualizar a versão secundária do mecanismo de uma instância Lindorm.

Sintaxe

show_variables_statement  ::= SHOW scope_expression VARIABLES
                              [ FROM table_identifier]
                              [ LIKE pattern_expression]
scop_expression           ::= { SYSTEM | TABLE }

Parâmetros

scope_expression

Defina se devem ser exibidos atributos do sistema ou da tabela.

Valor	LindormTable	LindormTSDB	Descrição
`SYSTEM`	Suportado	Suportado	Retorna todos os atributos do sistema que foram modificados
`TABLE`	Suportado (2.6.3+, Lindorm SQL 2.6.6+)	Não suportado	Retorna os atributos da tabela especificada na cláusula `FROM`

Nota

SYSTEM retorna apenas atributos definidos explicitamente. Caso nenhum atributo do sistema tenha sido modificado, o resultado será vazio.

FROM table_identifier

A palavra-chave FROM é suportada somente quando o parâmetro scope_expression estiver definido como TABLE, não sendo aplicável a SYSTEM.

LIKE pattern_expression

Filtra os resultados pelo nome do atributo usando um padrão de string. Dois curingas são suportados:

Curinga	Correspondência
`%`	Zero ou mais caracteres
`_`	Exatamente um caractere

Resultados retornados

Escopo SYSTEM: Retorna atributos do sistema que foram modificados. Se não houver modificações nos atributos do sistema, nenhum resultado será retornado. Para obter a lista completa de atributos configuráveis do sistema, consulte Itens de configuração suportados.
Escopo TABLE: Retorna atributos da tabela que incluem, mas não se limitam aos atributos configuráveis na sintaxe CREATE TABLE. Para obter a lista completa de atributos configuráveis da tabela, consulte Opções de tabela.

Exemplos

Todos os exemplos utilizam um conjunto de resultados com duas colunas: Variable_name e Value.

Visualizar todos os atributos do sistema

SHOW SYSTEM VARIABLES;

Resultado:

+--------------------------+-------+
|      Variable_name       | Value |
+--------------------------+-------+
| SLOW_QUERY_RECORD_ENABLE | true  |
| FILE_FORMAT_VERSION      | 5     |
+--------------------------+-------+

O resultado mostra apenas atributos definidos explicitamente. Se nenhuma alteração tiver sido feita nos atributos do sistema, o resultado estará vazio.

Visualizar um atributo específico da tabela

O exemplo a seguir utiliza uma tabela criada com esta instrução:

CREATE TABLE dt (p1 VARCHAR, c1 INTEGER, PRIMARY KEY(p1)) WITH (COMPRESSION = 'LZ4');

Para visualizar o algoritmo de compactação configurado para a tabela dt:

SHOW TABLE VARIABLES FROM dt LIKE 'COMPRESSION';

Resultado:

+---------------+-------+
| Variable_name | Value |
+---------------+-------+
| COMPRESSION   | LZ4   |
+---------------+-------+

Filtrar atributos do sistema usando curingas

Use % para corresponder a um prefixo e retornar todos os atributos cujos nomes começam com FILE:

SHOW SYSTEM VARIABLES LIKE 'FILE%';

Resultado:

+---------------------+-------+
|    Variable_name    | Value |
+---------------------+-------+
| FILE_FORMAT_VERSION | 5     |
+---------------------+-------+

Utilize um nome exato de atributo com LIKE para retornar um único atributo:

SHOW SYSTEM VARIABLES LIKE 'FILE_FORMAT_VERSION';

Resultado:

+---------------------+-------+
|    Variable_name    | Value |
+---------------------+-------+
| FILE_FORMAT_VERSION | 5     |
+---------------------+-------+

Próximos passos

ALTER SYSTEM — modifique atributos no nível do sistema
CREATE TABLE — configure atributos da tabela durante a criação
ALTER TABLE — modifique atributos da tabela após a criação