SHOW 命令参考
功能概述
列出云器 Lakehouse 中指定类型的现有对象。
语法
SHOW <object_type_plural>
[ IN <scope_object_name> ]
[ LIKE '<pattern>' | WHERE <expression> ]
[ LIMIT <num> ]
参数说明
| 参数 | 说明 | 是否必填 |
|---|
<object_type_plural>
<object_type_plural> | 要列出的对象类型（复数形式），如 TABLES
TABLES 、SCHEMAS
SCHEMAS 等 | 是 |
IN <scope>
IN <scope> | 限定对象的作用域层级 | 否 |
LIKE '<pattern>'
LIKE '<pattern>' | 使用通配符模式匹配对象名称（支持 %
% 和 _
_ ） | 否 |
WHERE <expression>
WHERE <expression> | 根据对象属性进行复杂过滤（与 LIKE 二选一） | 否 |
LIMIT <num>
LIMIT <num> | 限制返回结果数量 | 否 |
作用域限定
| 对象类型 | 作用域格式 | 示例 |
|---|
| TABLE/VIEW/MATERIALIZED VIEW/SYNONYM/VOLUME/TABLE STREAM/PIPE | IN schema_name
IN schema_name | SHOW TABLES IN sales
SHOW TABLES IN sales |
| 作业 | IN VCLUSTER vc_name
IN VCLUSTER vc_name | SHOW JOBS IN VCLUSTER prod
SHOW JOBS IN VCLUSTER prod |
| 索引/列 | IN table_name
IN table_name | SHOW COLUMNS IN orders
SHOW COLUMNS IN orders |
| SCHEMA/VCLUSTER/USERS/ROLES | IN workspace_name
IN workspace_name | SHOW SCHEMAS IN my_workspace
SHOW SCHEMAS IN my_workspace |
| 分区 | 不支持 IN
IN | SHOW PARTITIONS table_name
SHOW PARTITIONS table_name |
| CONNECTION/SHARE/FUNCTION | 不支持作用域限定 | SHOW CONNECTIONS
SHOW CONNECTIONS |
结果过滤
-
LIKE '<pattern>'
LIKE '<pattern>'
：使用通配符模式匹配对象名称
SHOW TABLES LIKE 'temp%' -- 匹配 temp 开头的表
-
WHERE <expression>
WHERE <expression>
：根据对象属性进行复杂过滤（支持全字段组合查询）
SHOW TABLES WHERE is_view = false AND table_name LIKE '%taxi%';
支持 WHERE 过滤的对象类型：
TABLE
TABLE
、TABLE STREAM
TABLE STREAM
、CONNECTION
CONNECTION
、VCLUSTER
VCLUSTER
、JOB
JOB
、SHARE
SHARE
、SYNONYM
SYNONYM
、PIPE
PIPE
、SCHEMA
SCHEMA
特殊语法
索引和列对象支持使用
FROM
FROM
替代
IN TABLE
IN TABLE
：
SHOW INDEXES FROM customers -- 等效于 SHOW INDEXES IN TABLE customers
SHOW COLUMNS FROM order_details -- 等效于 SHOW COLUMNS IN TABLE order_details
注意事项
LIKE
LIKE
和 WHERE
WHERE
只能二选一使用- 模式匹配区分大小写
WHERE
WHERE
子句支持标准 SQL 表达式语法DROP SCHEMA
DROP SCHEMA
会级联删除该 Schema 下的所有对象- CONNECTION 和 SHARE 不支持作用域限定
语法参考
用户与权限
Schema 与 Catalog
数据对象
索引与同义词
管道与 Volume
计算与作业
连接与共享
