SHOW TABLES
SHOW TABLES
概要
StarRocksデータベースまたは外部データソース(例:Hive、Iceberg、Hudi、Delta Lake)のすべてのテーブルを表示します。
注意
外部データソースのテーブルを表示するには、対応する外部カタログのUSAGE権限を持っている必要があります。
構文
SHOW TABLES [FROM <catalog_name>.<db_name>]
パラメータ
パラメーター | 必須 | 説明 |
---|---|---|
catalog_name | 任意 | 内部カタログまたは外部カタログの名前を指定します。
内部および外部のカタログを表示するには、 SHOW CATALOGS を実行できます。 |
db_name | 任意 | データベース名です。指定しない場合、デフォルトで現在のデータベースが使用されます。 |
例
例1: StarRocksクラスタに接続した後、データベースexample_db
内のテーブルを表示します。以下の2つのステートメントは等価です。
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 |
+----------------------------+
例2: データベースに接続した後、現在のデータベースexample_db
内のテーブルを表示します。
show tables;
+----------------------------+
| Tables_in_example_db |
+----------------------------+
| depts |
| depts_par |
| emps |
| emps2 |
+----------------------------+
例3: 外部カタログhudi_catalog
のデータベースhudi_db
内のテーブルを表示します。
show tables from hudi_catalog.hudi_db;
+----------------------------+
| Tables_in_hudi_db |
+----------------------------+
| hudi_sync_mor |
| hudi_table1 |
+----------------------------+
代わりに、SET CATALOGを実行して外部カタログhudi_catalog
に切り替え、その後SHOW TABLES FROM hudi_db;
を実行することもできます。
参考
- SHOW CATALOGS: StarRocksクラスタのすべてのカタログを表示します。
- SHOW DATABASES: 内部カタログまたは外部カタログのすべてのデータベースを表示します。
- SET CATALOG: カタログ間を切り替えます。