跳到主要内容
版本:3.2

SHOW TABLES

功能

查看指定数据库下的所有表。可以是 StarRocks 内部表或外部数据源中的表。

注意

要查看外部数据源中的表,必须有对应 External Catalog 的 USAGE 权限。

语法

SHOW TABLES [FROM <catalog_name>.<db_name>]

参数说明

参数必选说明
catalog_nameInternal catalog 或 External catalog 的名称。
  • 如果不指定或指定为 internal catalog 名称(default_catalog),则查看当前 StarRocks 集群中的数据库。
  • 如果指定 external catalog 名称,则查看外部数据源中的数据库。
您可以使用 SHOW CATALOGS 命令查看当前集群的内外部 catalog。
db_name数据库名称。如果不指定,默认为当前数据库。

示例

示例一:连接到 StarRocks 集群后,查看 Internal catalog 下数据库 example_db 中的表。下面两个语句功能对等。

show tables from example_db;
+----------------------------+
| Tables_in_example_db |
+----------------------------+
| depts |
| depts_par |
| emps |
| emps2 |
+----------------------------+

show tables from default_catalog.example_db;
+----------------------------+
| Tables_in_example_db |
+----------------------------+
| depts |
| depts_par |
| emps |
| emps2 |
+----------------------------+

示例二:使用 USE <db_name>; 连接到 example_db 数据库后,查看当前数据库下的表。

show tables;

+----------------------------+
| Tables_in_example_db |
+----------------------------+
| depts |
| depts_par |
| emps |
| emps2 |
+----------------------------+

示例三:查看 External catalog hudi_catalog 下指定数据库 hudi_db 中的表。

show tables from hudi_catalog.hudi_db;
+----------------------------+
| Tables_in_hudi_db |
+----------------------------+
| hudi_sync_mor |
| hudi_table1 |
+----------------------------+

您也可以通过 SET CATALOG <catalog_name>; 切换到 hudi_catalog 下,然后执行 SHOW TABLES FROM hudi_db; 来查看该数据库下的表。

相关文档