共用方式為


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