SHOW VOLUMES
適用対象: Databricks SQL Databricks Runtime 13.3 LTS 以降 Unity Catalog のみ
現在または必要に応じて指定されたスキーマで、現在のユーザーがアクセスできるすべてのボリュームを一覧表示します。 さらに、このステートメントの出力は、オプションの一致パターンによってフィルター処理できます。
構文
SHOW VOLUMES [ { FROM | IN } schema_name ] [ [ LIKE ] regex_pattern } ]
パラメーター
-
ボリュームが一覧表示されるスキーマを指定します。
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