SHOW VOLUMES

适用于:勾选“是” Databricks SQL 勾选“是” Databricks Runtime 13.3 LTS 及更高版本 勾选“是” 仅 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