SHOW VOLUMES

  • 项目

适用于：勾选“是”Databricks SQL勾选“是”Databricks Runtime 13.2 及更高版本勾选“是”仅 Unity Catalog

列出当前架构或可选指定架构中当前用户可访问的所有卷。 此外，此语句的输出可以通过可选的匹配模式进行筛选。

语法

SHOW VOLUMES [ { FROM | IN } schema_name ] [ [ LIKE ] regex_pattern } ]

参数

  • schema_name

    指定要在其中列出卷的架构。

  • regex_pattern

    用于筛选语句结果的具有正则表达式模式的 STRING 文本。

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

返回

具有两个列的结果集：

  • database STRING NOT NULL：卷的架构
  • volumeName STRING NOT NULL：卷的名称

示例

- List all volumes accessible by the caller
> SHOW VOLUMES
  database         volumeName
  ---------------- ----------
  default          my_external_volume
  default          another_volume
  default          foo_volume

- List all volumes under schema `machine_learning`
> SHOW VOLUMES IN machine_learning
  database         volumeName
  ---------------- ----------
  machine_learning bar_volume

- List all volumes whose name starts with 'a'
> SHOW VOLUMES LIKE 'a*'
  database         volumeName
  ---------------- ----------
  default          another_volume