Freigeben über

SHOW VOLUMES

  • Artikel

Gilt für: Häkchen ja Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime 13.3 LTS und höher durch Häkchen mit „Ja“ markiert Nur Unity Catalog

Listet alle Volumes auf, auf die der/die aktuelle Benutzer*in im aktuellen oder optional angegebenen Schema zugreifen kann. Darüber hinaus kann die Ausgabe dieser Anweisung nach einem optionalen Muster für den Abgleich gefiltert werden.

Syntax

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

Parameter

  • schema_name

    Gibt das Schema an, in dem Volumes aufgelistet werden sollen.

  • regex_pattern

    Ein STRING-Literal mit einem Muster in Form eines regulären Ausdrucks, das zum Filtern der Ergebnisse der Anweisung verwendet wird.

    • Mit Ausnahme von * und | funktioniert das Muster wie ein regulärer Ausdruck.
    • * allein entspricht 0 oder mehr Zeichen, und | wird verwendet, um mehrere verschiedene reguläre Ausdrücke zu trennen, von denen jeder übereinstimmen kann.
    • Führende und nachgestellte Leerzeichen werden vor der Verarbeitung im Eingabemuster abgeschnitten. Bei der Musterübereinstimmung wird keine Groß-/Kleinschreibung beachtet.

Gibt zurück

Ein Resultset mit zwei Spalten:

  • database STRING NOT NULL: das Schema des Volumes
  • volumeName STRING NOT NULL: der Name des Volumes

Beispiele

– 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