SHOW VARIABLES语法用于展示系统属性或特定表的属性。通过CREATE TABLE
设置表属性或通过ALTER TABLE
修改表属性后,您可以使用SHOW VARIABLES
语句来验证表属性是否设置成功。您也可以通过SHOW VARIABLES
语句来确认系统属性配置是否合理,例如慢查询视图是否已打开、是否已开启鉴权等。本文介绍SHOW VARIABLES语法的使用方法。
引擎与版本
SHOW VARIABLES语法适用于宽表引擎和时序引擎。
宽表引擎2.6.2及以上版本支持SHOW VARIABLES语法。如何查看或升级当前版本,请参见宽表引擎版本说明和升级小版本。
时序引擎3.4.35及以上版本支持SHOW VARIABLES语法。如何查看或升级时序引擎版本,请参见时序引擎版本说明和升级小版本。
要求Lindorm SQL为2.6.3.2以上版本。如何查看Lindorm SQL的版本,请参见SQL版本说明。
语法
show_variables_statement ::= SHOW scope_expression VARIABLES
[ FROM table_identifier]
[ LIKE pattern_expression]
scop_expression ::= { SYSTEM | TABLE }
使用说明
范围关键字(scope_expression)
范围关键字用于指定属性范围,支持TABLE和SYSTEM两种范围。指定TABLE关键字,展示指定表的表属性。指定SYSTEM关键字,展示所有系统属性。
宽表引擎和时序引擎对范围关键字的支持情况如下:
范围关键字 | 宽表引擎 | 时序引擎 |
TABLE | 〇 重要 要求宽表引擎为2.6.3及以上版本,Lindorm SQL为2.6.6以上版本。如何查看宽表引擎的版本,请参见宽表引擎版本说明。 | ✖️ |
SYSTEM | 〇 | 〇 |
查找表达式(LIKE pattern_expression)
LIKE
关键字后的查找表达式是一个字符串常量,系统将根据该字符串常量模糊匹配系统属性。该字符串常量仅支持以下通配符:
%
:替代0个或多个字符。_
:替代一个字符。
FROM
仅范围关键字(scope_expression)为TABLE时,支持FROM关键字。
返回结果说明
示例
展示所有系统属性
SHOW SYSTEM VARIABLES;
返回结果:
+--------------------------+-------+
| Variable_name | Value |
+--------------------------+-------+
| SLOW_QUERY_RECORD_ENABLE | true |
| FILE_FORMAT_VERSION | 5 |
+--------------------------+-------+
展示特定表的表属性
假设表结构如下:
CREATE TABLE dt (p1 VARCHAR, c1 INTEGER, PRIMARY KEY(p1)) WITH (COMPRESSION = 'LZ4');
执行以下语句,展示表dt的压缩算法。
SHOW TABLE VARIABLES FROM dt LIKE 'COMPRESSION';
返回结果:
+---------------+-------+
| Variable_name | Value |
+---------------+-------+
| COMPRESSION | LZ4 |
+---------------+-------+
模糊匹配系统属性
使用
_
通配符模糊,展示特定的系统属性。SHOW SYSTEM VARIABLES LIKE 'FILE_FORMAT_VERSION';
返回结果:
+---------------------+-------+ | Variable_name | Value | +---------------------+-------+ | FILE_FORMAT_VERSION | 5 | +---------------------+-------+
展示所有以
FILE
开头的系统属性。SHOW SYSTEM VARIABLES LIKE 'FILE%';
返回结果:
+---------------------+-------+ | Variable_name | Value | +---------------------+-------+ | FILE_FORMAT_VERSION | 5 | +---------------------+-------+