一、语法总览
| 序号 | 命令 | 功能 |
| 1 | SHOW DATABASES | 列出服务器上的数据库 |
| 2 | SHOW TABLES | 列出库中的表 |
| 3 | SHOW VIEWS | 列出库中的视图 |
| 4 | SHOW COLUMNS | 列出表的所有列 |
| 5 | SHOW CREATE TABLE | 返回建表/建视图 DDL |
| 6 | SHOW PARTITIONS | 列出表的所有分区 |
| 7 | SHOW FUNCTIONS | 列出所有函数 |
| 8 | SHOW TBLPROPERTIES | 返回表的属性 |
| 9 | SHOW TABLE EXTENDED | 显示匹配正则的表信息 |
四、功能描述
列出服务器上的数据库。支持可选的 LIKE 过滤。
五、语法
SHOW { DATABASES | SCHEMAS } [ [ LIKE ] pattern ];
六、参数说明
| 参数 | 说明 |
| DATABASES / SCHEMAS | 二者等价,SCHEMAS 是 SQL 标准写法 |
| [ LIKE pattern ] | 可选,按模式过滤数据库名 |
七、示例
SHOW DATABASES;SHOW SCHEMAS;
九、功能描述
列出当前数据库或指定数据库中的所有表。
十、语法
SHOW TABLES [ { IN | FROM } database_name ] [ [ LIKE ] pattern ];
十一、参数说明
| 参数 | 说明 |
| IN / FROM database_name | 指定数据库,省略则使用当前数据库 |
| [ LIKE pattern ] | 可选,按模式过滤表名 |
十二、示例
SHOW TABLES;SHOW TABLES IN default;
十四、功能描述
列出当前数据库或指定数据库中的所有视图。
十五、语法
SHOW VIEWS { IN | FROM } database_name [ [ LIKE ] pattern ];
十六、参数说明
| 参数 | 说明 |
| IN / FROM database_name | 指定数据库,省略则使用当前数据库 |
| [ LIKE pattern ] | 可选,按模式过滤视图名 |
十七、示例
— 创建基础表和视图CREATE EXTERNAL TABLE sv_base_table (id INT, name STRING) USING PARQUET LOCATION 'cosn://<your_bucket_name>/test_show_views/sv_base_table';INSERT INTO sv_base_table VALUES (1, 'Alice'), (2, 'Bob'), (3, 'Charlie');CREATE VIEW sv_test_view AS SELECT * FROM sv_base_table WHERE id > 0;CREATE VIEW sv_extra_view AS SELECT name FROM sv_base_table WHERE id <= 2;SHOW VIEWS IN default;SHOW VIEWS IN default LIKE 'sv_test*';SELECT * FROM sv_test_view ORDER BY id;
十九、功能描述
列出表中的所有列。
20、语法
SHOW COLUMNS { IN | FROM } table_name [ { IN | FROM } database_name ];
21、参数说明
| 参数 | 说明 |
| table_name | 目标表名 |
| database_name | 可选,限定库名 |
22、示例
CREATE EXTERNAL TABLE show_col_t1 ( id INT, name STRING, score DOUBLE, is_active BOOLEAN, created_at TIMESTAMP) USING PARQUETLOCATION 'cosn://<your_bucket_name>/test_show_columns/show_col_t1';INSERT INTO show_col_t1 VALUES (1, 'Alice', 95.5, true, current_timestamp());SHOW COLUMNS IN show_col_t1; SHOW COLUMNS FROM show_col_t1;SHOW COLUMNS IN default.show_col_t1;
24、功能描述
返回创建给定表的 CREATE TABLE 语句或 CREATE VIEW 语句。
25、语法
SHOW CREATE TABLE table_identifier;
26、参数说明
| 参数 | 说明 |
| table_identifier | 表或视图名称,可加库名限定:[ database_name. ] table_or_view_name |
27、示例
CREATE EXTERNAL TABLE sct_t1 (id INT, name STRING) USING PARQUET LOCATION 'cosn:///<your_bucket_name>/test_show_create_table/sct_t1';INSERT INTO sct_t1 VALUES (1, 'Alice'), (2, 'Bob');SHOW CREATE TABLE sct_t1; — 返回表的 DDLCREATE VIEW sct_v1 AS SELECT * FROM sct_t1;SHOW CREATE TABLE sct_v1; — 返回 VIEW 的 DDL
29、功能描述
列出表的所有分区。支持按部分分区键过滤。
30、语法
SHOW PARTITIONS table_identifier [ partition_spec ];partition_spec: PARTITION ( partition_col_name = partition_col_val [ , … ] )
31、参数说明
| 参数 | 说明 |
| table_identifier | 目标分区表名称 |
| partition_spec | 可选,指定部分分区键进行过滤 |
32、示例
— 使用管理表创建二级分区表CREATE EXTERNAL TABLE sp_t1 ( id INT, name STRING) PARTITIONED BY (dept STRING, year INT) STORED AS PARQUET LOCATION 'cosn:///<your_bucket_name>/test_show_partitions/sct_t1';INSERT INTO sp_t1 PARTITION(dept='eng',year=2024) VALUES (1,'Alice');INSERT INTO sp_t1 PARTITION(dept='sales',year=2024) VALUES (2,'Bob');INSERT INTO sp_t1 PARTITION(dept='eng',year=2025) VALUES (3,'Charlie');SHOW PARTITIONS sp_t1; — 显示全部分区SHOW PARTITIONS sp_t1 PARTITION(dept='eng'); — 按部分分区键过滤
34、功能描述
列出所有函数,包括临时函数和内置函数。支持 LIKE 过滤。
35、语法
SHOW FUNCTIONS [ [ LIKE ] pattern ];
36、参数说明
| 参数 | 说明 |
| [ LIKE pattern ] | 可选,按模式过滤函数名 |
37、示例
SHOW FUNCTIONS;SHOW FUNCTIONS LIKE 'abs';SHOW SYSTEM FUNCTIONS LIKE 'sum';
39、功能描述
返回表的属性(TBLPROPERTIES),支持查询全部属性或指定单个属性值。
40、语法
SHOW TBLPROPERTIES table_identifier [ ( property_key ) ];
41、参数说明
| 参数 | 说明 |
| table_identifier | 目标表名称 |
| property_key | 可选,查询指定的单个属性键 |
42、示例
CREATE EXTERNAL TABLE stp_t1 (id INT, name STRING) USING PARQUET TBLPROPERTIES ('custom_key1' = 'custom_value1', 'custom_key2' = 'custom_value2') LOCATION 'cosn://<your_bucket_name>/test_show_tblproperties/stp_t1';SHOW TBLPROPERTIES stp_t1; — 全部属性SHOW TBLPROPERTIES stp_t1 ('custom_key1'); — 指定自定义属性SHOW TBLPROPERTIES stp_t1 ('transient_lastDdlTime'); — 系统内置属性
44、功能描述
显示匹配给定正则表达式的所有表的详细信息(包含 Schema、Location、Properties 等)。
45、语法
SHOW TABLE EXTENDED [ { IN | FROM } database_name ] LIKE 'pattern';
46、参数说明
| 参数 | 说明 |
| IN / FROM database_name | 可选,限定数据库 |
| 'pattern' | 正则表达式或通配符模式,用于匹配表名 |
47、示例
CREATE EXTERNAL TABLE ste_test_tbl ( id INT, name STRING, score DOUBLE) USING PARQUET LOCATION 'cosn://<your_bucket_name>/test_show_table_extended/ste_test_tbl' TBLPROPERTIES ('testPurpose' = 'showTableExtended');INSERT INTO ste_test_tbl VALUES (1, 'Alice', 95.5), (2, 'Bob', 88.0);SHOW TABLE EXTENDED LIKE 'ste_*'; — 通配符匹配SHOW TABLE EXTENDED IN default LIKE 'ste_test_tbl'; — 指定库 + 精确匹配