SHOW VOLUMES

  • [アーティクル]

適用対象:check marked yes Databricks SQL Databricks Runtime 13.3 LTS 以上 Unity Catalog のみ

現在または必要に応じて指定されたスキーマで、現在のユーザーがアクセスできるすべてのボリュームを一覧表示します。 さらに、このステートメントの出力は、オプションの一致パターンによってフィルター処理できます。

構文

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

パラメーター

  • schema_name

    ボリュームが一覧表示されるスキーマを指定します。

  • regex_pattern

    ステートメントの結果をフィルター処理するために使用される正規表現パターン付きの STRING リテラル。

    • * と | の文字を除き、パターンは正規表現のように機能します。
    • * は単独で 0 個以上の文字に一致し、| は一致する可能性がある複数の異なる正規表現を区切るために使用されます。
    • 先頭と末尾の空白は、処理前に入力パターンでトリミングされます。 パターンの一致では、大文字と小文字は区別されません。

返品

2 つの列を含む結果セット:

  • 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