跳到主要内容
版本:3.0

SHOW CATALOGS

功能

查看当前集群中的所有 Catalog,包括 Internal Catalog 和 External Catalog。

注意

只有拥有 External Catalog USAGE 权限的用户才能查看到该 Catalog。如果没有该权限,仅返回 default_catalog。您可以使用 GRANT 命令进行授权操作。

语法

SHOW CATALOGS

返回结果说明

+----------+--------+----------+
| Catalog | Type | Comment |
+----------+--------+----------+

返回结果中的字段说明如下:

字段说明
CatalogCatalog 名称。
TypeCatalog 类型。如果是 default_catalog,则返回 Internal。如果是 external catalog,则返回 external catalog 的类型,例如 Hive, Hudi, Iceberg
CommentCatalog 的备注。
  • 在创建 external catalog 时不支持为 external catalog 添加备注,所以如果是 external catalog,则返回的 CommentNULL
  • 如果是 default_catalog,则默认返回的 CommentAn internal catalog contains this cluster's self-managed tables.default_catalog 是 StarRocks 集群中唯一的 internal catalog,不允许删除。

示例

查看当前集群中的所有 catalog。

SHOW CATALOGS\G
*************************** 1. row ***************************
Catalog: default_catalog
Type: Internal
Comment: An internal catalog contains this cluster's self-managed tables.
*************************** 2. row ***************************
Catalog: hudi_catalog
Type: Hudi
Comment: NULL
*************************** 3. row ***************************
Catalog: iceberg_catalog
Type: Iceberg
Comment: NULL