Compartilhar via

SHOW VOLUMES

  • Artigo

Aplica-se a: verificação marcada como sim SQL do Databricks verificação marcada como sim Databricks Runtime 13.3 LTS e superior verificação marcada como sim Somente Catálogo do Unity

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

Sintaxe

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

Parâmetros

  • schema_name

    Especifica o esquema em que as funções devem ser listadas.

  • regex_pattern

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

    • Com exceção dos caracteres * e |, ele funciona como uma expressão regular.
    • * só corresponde a zero ou mais caracteres e | é usado para separar várias expressões regulares diferentes, que podem 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ões não diferencia maiúsculas de minúsculas.

Retorna

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