SHOW VARIABLES

SHOW VARIABLES语法用于展示系统属性或特定表的属性。通过CREATE TABLE设置表属性或通过ALTER TABLE修改表属性后,您可以使用SHOW VARIABLES语句来验证表属性是否设置成功。您也可以通过SHOW VARIABLES语句来确认系统属性配置是否合理,例如慢查询视图是否已打开、是否已开启鉴权等。本文介绍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关键字。

返回结果说明

  • 范围关键字(scope_expression)为SYSTEM时支持返回的系统属性,请参见已支持的配置项列表

    说明

    如果所有系统属性均未修改过,SHOW VARIABLES返回为空。

  • 范围关键字(scope_expression)为TABLE时支持返回的属性包含但不限于CREATE TABLE中可设置的表属性。表属性的详细介绍,请参见 可设置的表属性

示例

展示所有系统属性

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     |
    +---------------------+-------+