共用方式為

SHOW VOLUMES

  • 發行項

適用於：檢查標示為 [是] Databricks SQL 檢查標示為 [是] Databricks Runtime 13.3 LTS 及以上版本，檢查標示為 [是]， Unity Catalog

列出當前使用者在當前或是選擇性指定的 schema中可存取的所有 volumes。 此外，此語句的輸出可能會透過選擇性的比對模式進行篩選。

語法

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

Parameters

  • schema_name

    指定要在 schema 中列出 volumes。

  • regex_pattern

    STRING具有正則表達式模式的常值，用來篩選語句的結果。

    • *除了 和 | 字元以外，模式的運作方式就像正則表達式。
    • * 單獨比對 0 或多個字元，並 | 用來分隔多個不同的正則表示式，其中任何一個都可以比對。
    • 前置和尾端空白會在處理之前，先在輸入模式中修剪。 模式比對不區分大小寫。

傳回

set 的結果，包含兩個 columns。

  • database STRING NOT NULL：磁碟區的 schema
  • 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