SHOW CATALOGS

适用于:勾选“是”Databricks SQL 勾选“是” Databricks Runtime 10.4 LTS 及更高版本 勾选“是” 仅 Unity Catalog

列出与选择性提供的正则表达式模式匹配的目录。 如果未提供模式,则命令将列出元存储中的所有目录。

语法

SHOW CATALOGS [ [ LIKE ] regex_pattern ]

参数

  • regex_pattern

    用于筛选语句结果的正则表达式模式。

    • *| 字符外,该模式的工作方式类似于正则表达式。
    • 只有 * 则匹配 0 个或多个字符,| 用于分隔多个不同的正则表达式,其中任何一个表达式都可以匹配。
    • 在处理前,在输入模式中删除前导空格和尾随空格。 模式匹配不区分大小写。

示例

-- Create catalogs.
> CREATE CATALOG payroll_cat;
> CREATE CATALOG payments_cat;

-- Lists all the catalogs.
> SHOW CATALOGS;
 catalog
 --------------
 hive_metastore
           main
   payments_cat
    payroll_cat

-- Lists catalogs with name starting with string pattern `pay`
> SHOW CATALOGS LIKE 'pay*';
 catalog
 ------------
 payments_cat
  payroll_cat