显示已删除的卷

适用于:检查标记为“是”的 Databricks SQL 检查标记为“是”是 Databricks Runtime 19.11 及更高 版本检查标记为“是 ”,仅限 Unity 目录

SHOW VOLUMES DROPPED 列出 Unity 目录架构中已删除的卷,该架构仍可恢复。

如果没有指定模式,则从当前模式中列出卷。 如果该模式或目录不存在,则会触发错误。

Syntax

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

参数

  • schema_name

    指定了丢弃卷的列表模式。 如果未提供,请使用当前架构。

  • 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