跳到主要内容

SHOW-CATALOGS

描述

该语句用于显示已存在是数据目录(catalog)

语法

SHOW CATALOGS [LIKE <catalog_name>]

说明:

LIKE:可按照 CATALOG 名进行模糊查询

可选参数

1. <catalog_name>

需要显示 catalog 的名字

返回值

Column nameDescription
CatalogId数据目录唯一 ID
CatalogName数据目录名称,其中 internal 是默认内置的 catalog,不可修改
Type数据目录类型
IsCurrent是否为当前正在使用的数据目录
CreateTime创建时间
LastUpdateTime最后更新时间
Comment备注

权限控制

权限(Privilege)对象(Object)说明(Notes)
ADMIN_PRIV / SELECT_PRIV / LOAD_PRIV / ALTER_PRIV / CREATE_PRIV / SHOW_VIEW_PRIV / DROP_PRIVCatalog需要有上述权限中的一种就可以

示例

  1. 查看当前已创建的数据目录

    SHOW CATALOGS;
     +-----------+-------------+----------+-----------+-------------------------+---------------------+------------------------+
    | CatalogId | CatalogName | Type | IsCurrent | CreateTime | LastUpdateTime | Comment |
    +-----------+-------------+----------+-----------+-------------------------+---------------------+------------------------+
    | 130100 | hive | hms | | 2023-12-25 16:11:41.687 | 2023-12-25 20:43:18 | NULL |
    | 0 | internal | internal | yes | UNRECORDED | NULL | Doris internal catalog |
    +-----------+-------------+----------+-----------+-------------------------+---------------------+------------------------+
  2. 按照目录名进行模糊搜索

    SHOW CATALOGS LIKE 'hi%';
    +-----------+-------------+----------+-----------+-------------------------+---------------------+------------------------+
    | CatalogId | CatalogName | Type | IsCurrent | CreateTime | LastUpdateTime | Comment |
    +-----------+-------------+----------+-----------+-------------------------+---------------------+------------------------+
    | 130100 | hive | hms | | 2023-12-25 16:11:41.687 | 2023-12-25 20:43:18 | NULL |
    +-----------+-------------+----------+-----------+-------------------------+---------------------+------------------------+