Condividi tramite

SHOW VOLUMES

  • Articolo

Si applica a:contrassegnato sì Databricks SQL contrassegnato sì Databricks Runtime 13.3 LTS e versioni successive contrassegnato sì solo Unity Catalog

Elenca tutti i volumi accessibili all'utente corrente nello schema corrente o facoltativamente specificato. Inoltre, l'output di questa istruzione può essere filtrato in base a un criterio di corrispondenza facoltativo.

Sintassi

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

Parametri

  • schema_name

    Specifica lo schema in cui devono essere elencati i volumi.

  • regex_pattern

    Un valore STRING letterale con un pattern di espressione regolare usato per filtrare i risultati della dichiarazione.

    • Ad eccezione dei caratteri * e |, il modello funziona come un'espressione regolare.
    • * corrisponde da solo a 0 o più caratteri e | viene utilizzato per separare diverse espressioni regolari, qualunque delle quali può corrispondere.
    • Gli spazi vuoti iniziali e finali vengono tagliati nel modello di input prima dell'elaborazione. La corrispondenza del criterio non fa distinzione tra maiuscole e minuscole.

Ritorni

Set di risultati con due colonne:

  • Il schema del volume
  • volumeName STRING NOT NULL: nome del volume

Esempi

– 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