SHOW 语句

列出指定对象类型的现有对象。

SHOW 命令语法文档

语法结构


SHOW <object_type_plural> 
[ IN <scope_object_name> ] 
[ LIKE '<pattern>' | WHERE <expression>  ] 
[ LIMIT <num> ]

参数详解

核心参数

<object_type_plural>（必需）
需展示的对象类型

作用域限定

IN <scope_object_name>（可选）
指定对象的作用域层级，对应关系如下表：

对象类型	作用域格式	示例
TABLE/VIEW/MATERIALIZED VIEW/SYNONYM/VOLUME/TABLE STREAM /PIPE	`IN schema_name`	`SHOW TABLES IN sales`
作业	`IN VCLUSTER vc_name`	`SHOW JOBS IN VCLUSTER prod`
索引/列	`IN table_name`	`SHOW COLUMNS IN orders`
SCHEMA /VCLUSTER/USERS/ROLES	`IN workspace_name`	`SHOW SCHEMA IN workspace_name`
分区	不支持使用IN关键字`table_name`	`SHOW PARTITIONS table_name`
CONNECTION/SHARE/FUNCTION	不支持作用域限定	`SHOW CONNECTIONS`

结果过滤

LIKE '<pattern>'（可选，与WHERE二选一）
使用通配符模式匹配对象名称（支持%和_）


SHOW TABLES LIKE 'temp%'  -- 匹配temp开头的表

WHERE <expression>（可选，与LIKE二选一） ,``` 支持用户根据命令显示的字段进行筛选。用户可以通过表达式对结果使用表达式进行复杂过滤，目前只有TABLE、TABLE STREAM、CONNECTION、VCLUSTER、JOB、SHARE、SYNONYM、VCLUSTER、PIPE对象支持。对象类型与可筛字段矩阵

对象类型	核心过滤字段（支持全字段组合查询）
TABLE	`table_name`, `is_view`, `is_materialized_view`, `is_external`, `is_dynamic`
TABLE STREAM	`create_time`, `name`, `table_name`, `mode`, `comment`
CONNECTION	`name`, `category`, `type`, `enabled`, `created_time`
VCLUSTER	`name`、`vcluster_type`、`max_concurrency`、`state`、`creator`、`create_time`、`min_replicas`、`max_replicas`、`min_vcluster_size`、`max_vcluster_size`、`current_vcluster_size`、`preload_tables`、`current_replicas`、`auto_suspend_in_second`、`auto_scale_in_in_second`、`running_jobs`、`queued_jobs`、`error_message`、`provision_mode`
JOB	`job_id`、`status`、`creator`、`priority`、`start_time`、`end_time`、`execution_time`、`vcluster_name`、`job_text`、`query_tag`
SHARE	`share_name`, `provider`, `provider_instance`, `scope`, `kind`
SYNONYM	`synonym_name`, `create_time`, `target_type`, `target_name`
PIPE	`pipe_name`, `pipe_kind`, `status`, `copy_statement`
SCHMA	`schema_name`, `type`


     SHOW TABLES WHERE table_name=base_a_dt;

结果限制

LIMIT <num>（可选）
限制返回结果数量


SHOW TABLES LIMIT 10

特殊语法形式索引/列的FROM语法,对于索引和列对象，支持使用FROM替代IN TABLE：


SHOW INDEXES FROM customers       -- 等效于 SHOW INDEXES IN TABLE customers
SHOW COLUMNS FROM order_details   -- 等效于 SHOW COLUMNS IN TABLE order_details

注意事项

conneciton和share不支持作用域限定
模式匹配区分大小写
WHERE子句支持标准SQL表达式语法
返回结果默认按对象名称排序

LIKE子句的使用示例


-- 查找名称中包含'taxi'的所有表
SHOW TABLES LIKE '%taxi%';

-- 查找名称以'yellow'开头的所有表
SHOW TABLES LIKE 'yellow%';

-- 查找名称中第二个字符为'a'的所有schema
SHOW SCHEMAS LIKE '_a%';

WHERE子句的使用示例


-- 查找所有不是视图的表
SHOW TABLES WHERE is_view=false;

-- 查找所有外部表
SHOW TABLES WHERE is_external=true;

-- 查找特定schema中的所有表
SHOW TABLES WHERE schema_name='mcp_demo';

-- 使用多个条件进行过滤
SHOW TABLES WHERE is_view=false AND table_name LIKE '%taxi%';

-- 查找特定连接的卷
SHOW VOLUMES WHERE connection='xxx.storage_connection';

-- 查找外部卷
SHOW VOLUMES WHERE external=true;