Compartir vía

SHOW VOLUMES

  • Artículo

Se aplica a: casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 13.3 LTS y versiones posteriores casilla marcada como Sí solo a Unity Catalog

Enumera todos los volúmenes accesibles para el usuario actual en el esquema actual u opcionalmente especificado. Además, la salida de esta instrucción puede filtrarse mediante un patrón de coincidencia opcional.

Sintaxis

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

Parámetros

  • schema_name

    Especifica el esquema en el que se van a enumerar los volúmenes.

  • regex_pattern

    STRING literal con un patrón de expresiones regulares que se usa para filtrar los resultados de la instrucción.

    • Salvo por los caracteres * y |, el patrón funciona como una expresión regular.
    • * por separado coincide con 0 o más caracteres y | se usa para separar varias expresiones regulares diferentes, cualquiera de las cuales puede coincidir.
    • Los espacios en blanco iniciales y finales se recortan en el patrón de entrada antes del procesamiento. La coincidencia de patrones no diferencia entre mayúsculas y minúsculas.

Devoluciones

Un conjunto de resultados con dos columnas:

  • database STRING NOT NULL: esquema del volumen.
  • volumeName STRING NOT NULL: nombre del volumen.

Ejemplos

– 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