SHOW CATALOGS

功能

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

注意

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

语法

SHOW CATALOGS [LIKE '<pattern>']

参数说明

参数	说明
pattern	可选。通过 LIKE 子句匹配 Catalog 名称的模式。% 匹配任意数量的字符，_ 匹配单个字符。仅返回名称与该模式匹配的 Catalog。

返回结果说明

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

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

字段	说明
Catalog	Catalog 名称。
Type	Catalog 类型。如果是 default_catalog，则返回 Internal。如果是 external catalog，则返回 external catalog 的类型，例如 Hive, Hudi, Iceberg。
Comment	Catalog 的备注。 在创建 external catalog 时不支持为 external catalog 添加备注，所以如果是 external catalog，则返回的 Comment 为 NULL。 如果是 default_catalog，则默认返回的 Comment 为 An 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

查看名称匹配特定模式的 catalog。

SHOW CATALOGS LIKE 'iceberg%'\G
*************************** 1. row ***************************
Catalog: iceberg_catalog
   Type: Iceberg
Comment: NULL