Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Aplica-se a:
Databricks SQL
Runtime 19.11 e superiores
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
-
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