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 für 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