Share via


VOLUMES WEERGEVEN

Van toepassing op:vinkje als ja aan Alleen Databricks SQL vinkje als ja aan Databricks Runtime 13.3 LTS en hoger vinkje als ja aan dan Unity Catalog

Geeft een lijst weer van alle volumes die toegankelijk zijn voor de huidige gebruiker in het huidige of optioneel opgegeven schema. Daarnaast kan de uitvoer van deze instructie worden gefilterd op een optioneel overeenkomend patroon.

Syntaxis

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

Parameters

  • schema_name

    Hiermee geeft u het schema op waarin volumes moeten worden vermeld.

  • regex_pattern

    Een STRING letterlijke term met een normaal expressiepatroon dat wordt gebruikt om de resultaten van de instructie te filteren.

    • Met uitzondering van * en | teken werkt het patroon als een reguliere expressie.
    • * alleen komt overeen met 0 of meer tekens en | wordt gebruikt om meerdere verschillende reguliere expressies te scheiden, die eventuele overeenkomen.
    • De voorloop- en volgspaties worden ingekort in het invoerpatroon voordat ze worden verwerkt. De patroonovereenkomst is niet hoofdlettergevoelig.

Retouren

Een resultatenset met twee kolommen:

  • database STRING NOT NULL: Het schema van het volume
  • volumeName STRING NOT NULL: De naam van het volume

Voorbeelden

– 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