SHOW VOLUMES LARGADO

Aplica-se a:assinalado Databricks SQL assinalado sim Databricks Runtime 19.11 e superiores assinalado sim apenas Unity Catalog

SHOW VOLUMES DROPPED lista os volumes abandonados num esquema do Catálogo Unity que ainda podem ser recuperados.

Se não for especificado o esquema, os volumes são listados a partir do esquema atual. Se o esquema ou catálogo não existir, surge um erro.

Syntax

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

Parameters

  • schema_name

    Especifica o esquema do qual os volumes eliminados são listados. Se não for fornecido, usa o esquema atual.

  • maxResultados

    Um literal inteiro que limita o número de volumes devolvidos.

Permissions

O comando lista apenas volumes que o requerente pode recuperar com o UN.DROP VOLUME Um utilizador deve possuir uma metastore, catálogo ou esquema (ou ter o privilégio MANAGE sobre o esquema) para listar todas as tabelas descartadas dentro desse seguro. Um utilizador que possui um volume perdido pode listar esse volume se tiver o USE CATALOG privilégio no catálogo pai e o USE SCHEMA privilégio no esquema pai.

Returns

O comando produz um relatório dos volumes abandonados com as seguintes colunas:

Name Tipo de Dados Anulável Description
catálogo STRING no O nome do catálogo do volume retirado.
esquema STRING no O nome do esquema do volume eliminado.
volume_name STRING no O nome do volume abandonado.
volume_id STRING no O ID de volume usado para identificar e desfazer um volume específico descartado com UNDROP VOLUME WITH ID.
proprietário STRING no O diretor que detém o volume.
comentário STRING yes O comentário opcional sobre volume.
criado_em STRING no A altura em que o volume foi criado.
criado_por STRING no O diretor que criou o volume.

Examples

-- 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