SHOW TABLES DROPPED

  • 项目

适用于：check marked yes Databricks SQL check marked yes Databricks Runtime 12.1 及更高版本

重要

此功能目前以公共预览版提供。

此命令列出已在 Unity Catalog 中的架构内删除的、但仍可取消删除的所有表。 具体而言，它会列出仍在保留期内（默认为 7 天）的所有已删除表。 如果架构或目录已被删除，则会引发错误。 如果未指定架构，则从当前架构返回表。

该命令仅列出请求者能够 UNDROP（取消删除）的表。 因此，元存储/目录/架构所有者有权列出其各自安全对象所有权范围内的所有已删除表。 具有表级所有权的用户只能查看他们在输入目录/架构中拥有的表，前提是他们对相关目录/架构拥有 USAGE 权限。

语法

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

参数

  • schema_name

    指定要从中列出表的架构名称。 如果未提供，则使用当前架构。 如果架构或目录不存在或已被删除，则会引发 SCHEMA_NOT_FOUND 错误。

  • maxResult

    一个用于限制返回的表数的整数文本。

返回

命令 s 生成包含以下列的表列表的报告：

名称 数据类型 Nullable 说明
catalogName STRING 否 列出的表的目录名称。
schemaName STRING 否 列出的表的架构名称。
tableName STRING 否 删除的表的名称
tableId STRING 否 表 ID，可用于识别和取消删除已删除表的特定版本。
tableType STRING 否 Unity Catalog 中已删除的表的类型
deletedAt STRING 否 删除表的时间。
createdAt STRING 否 创建表的时间。
updatedAt STRING 否 上次更新表的时间。
createdBy STRING 否 创建表的主体。
owner STRING 否 拥有表的主体。
comment STRING 是 可选的表注释。

示例

— List dropped tables from an existing schema + catalog.
> USE CATALOG default;
> USE SCHEMA my_schema;
> CREATE TABLE my_table_1;
> CREATE TABLE my_table_2;
> DROP TABLE my_table_1;
> SHOW TABLES DROPPED;
  catalogname schemaname tablename  tableid tabletype deletedat                     createdat                     updatedat                     createdby     owner         comment
  ----------- ---------- ---------- ------- --------- ----------------------------- ----------------------------- ----------------------------- ------------- ------------- -------
  default     my_schema  my_table_1 <uuid>  managed   2023-05-03 AD at 18:17:56 UTC 2023-05-03 AD at 18:17:00 UTC 2023-05-03 AD at 18:17:00 UTC alf@melmak.et alf@melmak.et

-- Create a new table with name `my_table_1` since other was dropped.
> CREATE TABLE my_table_1;
> DROP TABLE my_table_1;
> SHOW TABLES DROPPED IN default.my_schema;
  catalogname schemaname tablename  tableid tabletype deletedat                     createdat                     updatedat                     createdby     owner         comment
  ----------- ---------- ---------- ------- --------- ----------------------------- ----------------------------- ----------------------------- ------------- ------------- -------
  default     my_schema  my_table_1 <uuid>  managed   2023-05-03 AD at 18:17:56 UTC 2023-05-03 AD at 18:17:00 UTC 2023-05-03 AD at 18:17:00 UTC alf@melmak.et alf@melmak.et

— List dropped tables when some are past the retention period.
> USE CATALOG default;
> USE SCHEMA my_schema;
> CREATE TABLE my_table_1;
> DROP TABLE my_table_1;
-- Wait 8 days (1 more than 7 day retention period)
> SHOW TABLES DROPPED;
  catalogname schemaname tablename  tableid tabletype deletedat                     createdat                     updatedat                     createdby     owner        comment
  ----------- ---------- ---------- ------- --------- ----------------------------- ----------------------------- ----------------------------- ------------- ------------ -------