SHOW TABLES DROPPED

适用于： Databricks SQL Databricks Runtime 12.2 LTS 及更高版本

重要

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

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

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

语法

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

参数

• schema_name

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

• maxResult

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

返回

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

名称	数据类型	可以为 Null	说明
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
  ----------- ---------- ---------- ------- --------- ----------------------------- ----------------------------- ----------------------------- ------------- ------------ -------

相关文章

• SHOW TABLES
• UNDROP