SHOW
用户可以通过SHOW语句查看Lindorm时序引擎中指定类型的元数据。
语法
show_statement ::= SHOW target_statement
target_statement ::= { DATABASES | TABLES | USERS | PRIVILEGES }
SHOW语句支持的对象如下所示:
DATABASES:查询当前实例中的全部数据库对象一览。
TABLES:查询当前实例中的全部时序数据表一览。
USERS:查询当前实例中的全部用户。
PRIVILEGES: 查询当前实例中的用户权限。
随着SHOW语句的对象不同,执行SHOW语句所需的权限也略有区别。详细可参见 常用SQL所需权限 。
返回结果集说明
所有的SHOW语句返回的结果,都以表的形式返回结果集。以下将对各语句的结果集进行说明。
SHOW DATABASES
列名 | 类型 | 结果说明 |
---|---|---|
database | VARCHAR | 实例中所有数据库名。 |
SHOW TABLES
列名 | 类型 | 结果说明 |
---|---|---|
Tables_In_${Database名} | VARCHAR | 当前数据库中的所有表名。 若想查看其他数据库中的表,可用USE语句切换当前数据库。 |
SHOW USERS
列名 | 类型 | 结果说明 |
---|---|---|
name | VARCHAR | 当前实例中的所有用户名。 |
SHOW PRIVILEGES
列名 | 类型 | 结果说明 |
---|---|---|
user | VARCHAR | 拥有任意访问权限的用户名。 |
global privileges | VARCHAR | 该用户拥有的GLOBAL权限集合。 |
database privileges | VARCHAR | 该用户拥有的DATABASE权限的集合。 |
table privileges | VARCHAR | 该权限拥有的TABLE级权限的集合。 |
为了便于应用处理,权限列中的数据都是以JSON的形式展示。JSON的结构如下:
key:访问对象的名称(如一个数据库名或一个表名)。全局权限的key固定为
GLOBAL
。value:权限的列表。详情可见下文的示例。
即使没有对应级别的权限,值也会是一个空JSON对象的字符串。
当前时序引擎暂不支持TABLE级的权限。
示例
展示当前实例中的数据库一览:
> SHOW DATABASES;
+----------+
| database |
+----------+
| default |
| metadata |
+----------+
2 rows in set (13 ms)
展示当前实例中的时序数据表一览:
> SHOW TABLES;
+-------------+------------+
| tableSchem | tableName |
+-------------+------------+
| default | sensor |
| metadata | COLUMNS |
| metadata | TABLES |
+-------------+------------+
3 rows selected (0.064 seconds)
展示当前实例中的用户一览:
> SHOW USERS;
+-----------+
| name |
+-----------+
| testuser |
| dbwriter |
| root |
+-----------+
3 rows in set (11 ms)
展示当前实例中的权限一览:
> SHOW PRIVILEGES;
+------------+-------------------------------------+--------------------------------------+------------------+
| user | global privileges | database privileges | table privileges |
+------------+-------------------------------------+--------------------------------------+------------------+
| testuser | {"GLOBAL":["READ"]} | {} | {} |
| dbaccessor | {"GLOBAL":["ADMIN","READ","WRITE"]} | {"DB2":["READ"],"default":["WRITE"]} | {} |
+------------+-------------------------------------+--------------------------------------+------------------+