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_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
----------- ---------- ---------- ------- --------- ----------------------------- ----------------------------- ----------------------------- ------------- ------------ -------