SHOW CATALOGS
功能概述
SHOW CATALOGS
SHOW CATALOGS
列出当前实例下所有可访问的 Catalog，包括本地托管 Catalog（MANAGED）、外部 Catalog（EXTERNAL）和共享数据集（SHARED）。返回结果与
SHOW WORKSPACES
SHOW WORKSPACES
相同。
语法
SHOW CATALOGS [ LIKE '<pattern>' ]
LIKE '<pattern>'
LIKE '<pattern>'
：可选，按名称过滤，支持
%
%
和
_
_
通配符。
返回字段
| 字段 | 说明 |
|---|
workspace_name
workspace_name | Catalog 名称 |
created_time
created_time | Catalog 创建时间 |
category
category | Catalog 类型：MANAGED
MANAGED （本地托管）、SHARED
SHARED （共享数据集）、EXTERNAL
EXTERNAL （外部 Catalog，如 Hive、Databricks） |
示例
SHOW CATALOGS;
+----------------------------+-------------------------+----------+
| workspace_name | created_time | category |
+----------------------------+-------------------------+----------+
| ns227206 | 2025-01-15 10:29:17.425 | MANAGED |
| clickzetta_sample_data | 2025-01-15 10:27:21.738 | SHARED |
| databricks_main_catalog | 2025-11-20 12:00:49.498 | EXTERNAL |
+----------------------------+-------------------------+----------+
查看外部 Catalog 中的 Schema 列表：
SHOW SCHEMAS IN clickzetta_sample_data;
注意事项
- 只显示当前用户有权访问的 Catalog，无权限的 Catalog 不会出现在结果中。
- 外部 Catalog（
EXTERNAL
EXTERNAL
类型）需要提前通过 CREATE EXTERNAL CATALOG
CREATE EXTERNAL CATALOG
注册，并且对应的 Catalog Connection 必须处于连通状态才能正常访问。
- 查看某个 Catalog 下的 Schema 和表，可使用
SHOW SCHEMAS IN catalog_name
SHOW SCHEMAS IN catalog_name
和 SHOW TABLES IN catalog_name.schema_name
SHOW TABLES IN catalog_name.schema_name
。
SHOW CATALOGS
SHOW CATALOGS
与 SHOW WORKSPACES
SHOW WORKSPACES
返回相同的结果，两者等价。EXTERNAL 和 SHARED 类型的 Catalog 只读，不支持在其中创建表或执行 DML。
