SHOW TABLES
説明
StarRocks データベースまたは外部データソースのデータベース内のすべてのテーブルを表示します。例えば、Hive、Iceberg、Hudi、Delta Lake などです。
注意
外部データソースのテーブルを表示するには、そのデータソースに対応する external catalog に対する USAGE 権限が必要です。
構文
SHOW TABLES [FROM <catalog_name>.<db_name>]
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
| catalog_name | いいえ | 内部 catalog または external catalog の名前。
|
| db_name | いいえ | データベース名。指定しない場合、デフォルトで現在のデータベースが使用されます。 |
例
例 1: StarRocks クラスターに接続した後、default_catalog のデータベース 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: external catalog hudi_catalog のデータベース hudi_db 内のテーブルを表示します。
show tables from hudi_catalog.hudi_db;
+----------------------------+
| Tables_in_hudi_db |
+----------------------------+
| hudi_sync_mor |
| hudi_table1 |
+----------------------------+
または、SET CATALOG を実行して external catalog hudi_catalog に切り替え、その後 SHOW TABLES FROM hudi_db; を実行することもできます。
参考文献
- SHOW CATALOGS: StarRocks クラスター内のすべての catalog を表示します。
- SHOW DATABASES: 内部 catalog または external catalog 内のすべてのデータベースを表示します。
- SET CATALOG: catalog 間を切り替えます。