Partilhar via


MOSTRAR VOLUMES

Aplica-se a:Marque Sim Databricks SQL Marque Sim Databricks Runtime 13.3 LTS e superior Marque Sim somente Unity Catalog

Lista todos os volumes acessíveis ao usuário atual no esquema atual ou opcionalmente especificado. Além disso, a saída desta instrução pode ser filtrada por um padrão de correspondência opcional.

Sintaxe

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

Parâmetros

  • schema_name

    Especifica o esquema no qual os volumes devem ser listados.

  • regex_pattern

    Um STRING literal com um padrão de expressão regular que é usado para filtrar os resultados da instrução.

    • Exceto por * e | caráter, o padrão funciona como uma expressão regular.
    • * sozinho corresponde a 0 ou mais caracteres e | é usado para separar várias expressões regulares diferentes, qualquer uma das quais pode corresponder.
    • Os espaços em branco à esquerda e à direita são cortados no padrão de entrada antes do processamento. A correspondência de padrão não diferencia maiúsculas de minúsculas.

Devoluções

Um conjunto de resultados com duas colunas:

  • database STRING NOT NULL: O esquema do volume
  • volumeName STRING NOT NULL: O nome do volume

Exemplos

– 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