适用于:
Databricks SQL
Databricks Runtime 19.11 及更高
”,仅限 Unity 目录
SHOW VOLUMES DROPPED 列出 Unity 目录架构中已删除的卷,该架构仍可恢复。
如果没有指定模式,则从当前模式中列出卷。 如果该模式或目录不存在,则会触发错误。
Syntax
SHOW VOLUMES DROPPED [ { FROM | IN } schema_name ] [ LIMIT maxResults ]
参数
-
指定了丢弃卷的列表模式。 如果未提供,请使用当前架构。
maxResults
一个整数字面量,限制返回的卷数。
Permissions
该命令仅列出请求者可以使用 UNDROP VOLUME 进行恢复的卷。 用户必须拥有元存储库、目录或模式(或拥有 MANAGE 模式访问权限),才能列出该可保护文件中所有丢弃的表。 拥有丢弃卷的用户如果拥有 USE CATALOG 父目录和 USE SCHEMA 父模式的权限,就可以列出该卷。
Returns
该命令生成包含以下列的丢弃卷报告:
| Name | 数据类型 | 可为 Null | Description |
|---|---|---|---|
| 目录 | STRING | no | 那本被取消的卷册目录名称。 |
| 架构 | STRING | no | 丢弃卷的模式名称。 |
| volume_name | STRING | no | 那本被丢弃的卷名。 |
| volume_id | STRING | no | 用于识别和解开特定丢弃音量的卷 ID。UNDROP VOLUME WITH ID |
| 所有者 | STRING | no | 负责这卷的校长。 |
| 注释 | STRING | 是的 | 关于可选音量的评论。 |
| 创建时间 | STRING | no | 卷册诞生的那个时间。 |
| created_by | STRING | no | 创作这卷的校长。 |
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