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 生成包含以下列的表列表的报告:

名称 数据类型 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
  ----------- ---------- ---------- ------- --------- ----------------------------- ----------------------------- ----------------------------- ------------- ------------ -------