SHOW VOLUMES DEJADO CAER

Se aplica a:con marca de verificación sí Databricks SQL marcado sí Databricks Runtime 19.11 y superiores con marca marcada sí Solo Unity Catálogo

SHOW VOLUMES DROPPED enumera los volúmenes eliminados en un esquema del Catálogo de Unity que aún pueden recuperarse.

Si no se especifica ningún esquema, los volúmenes se listan desde el esquema actual. Si el esquema o catálogo no existe, se genera un error.

Syntax

SHOW VOLUMES DROPPED [ { FROM | IN } schema_name ] [ LIMIT maxResults ]

Parameters

  • schema_name

    Especifica el esquema del que se listan los volúmenes eliminados. Si no se proporciona, utiliza el esquema actual.

  • maxResultados

    Un literal entero que limita el número de volúmenes devueltos.

Permissions

El comando solo lista volúmenes que el solicitante puede recuperar con UN.DROP VOLUME Un usuario debe poseer una metastore, catálogo o esquema (o tener el MANAGE privilegio sobre el esquema) para listar todas las tablas eliminadas dentro de ese seguro. Un usuario que posee un volumen eliminado puede listar ese volumen si tiene el USE CATALOG privilegio en el catálogo padre y el USE SCHEMA privilegio en el esquema padre.

Devoluciones

El comando produce un informe de volúmenes eliminados con las siguientes columnas:

Name Tipo de datos Anulable Description
catalog STRING No El nombre del catálogo del volumen eliminado.
schema STRING No El nombre del esquema del volumen eliminado.
volume_name STRING No El nombre del volumen que se ha caído.
volume_id STRING No El ID de volumen usado para identificar y desactivar un volumen eliminado específico con UNDROP VOLUME WITH ID.
owner STRING No El director que posee el volumen.
comment STRING Sí El comentario opcional sobre volumen.
fecha_de_creación STRING No El momento en que se creó el volumen.
created_by STRING No El director que creó el volumen.

Ejemplos

-- Create and drop a volume, then list the dropped volumes in the current schema.
> USE CATALOG my_catalog;
> USE SCHEMA my_schema;
> CREATE VOLUME my_volume;
> DROP VOLUME my_volume;
> SHOW VOLUMES DROPPED;
  catalog    schema    volume_name volume_id                            owner         comment created_at                    created_by
  ---------- --------- ----------- ------------------------------------ ------------- ------- ----------------------------- -------------
  my_catalog my_schema my_volume   6ca7be55-8f58-47a7-85ee-7a59082fd17a alf@melmak.et         2023-05-03 AD at 18:17:00 UTC alf@melmak.et

-- List dropped volumes from a different schema, limiting the results.
> CREATE VOLUME my_catalog.other_schema.other_volume;
> DROP VOLUME my_catalog.other_schema.other_volume;
> SHOW VOLUMES DROPPED IN my_catalog.other_schema LIMIT 10;
  catalog    schema       volume_name  volume_id                            owner         comment created_at                    created_by
  ---------- ------------ ------------ ------------------------------------ ------------- ------- ----------------------------- -------------
  my_catalog other_schema other_volume b819f397-c51f-4e60-8acc-05d4d4a7e084 alf@melmak.et         2023-05-04 AD at 08:20:00 UTC alf@melmak.et