SHOW TABLES DROPPED
描述
此命令列出已在 Unity Catalog 中的架构内删除的、但仍可取消删除的所有表。 具体而言，它会列出仍在保留期内（默认为 7 天）的所有已删除表。 如果架构或目录已被删除，则会引发错误。 如果未指定架构，则从当前架构返回表。
该命令仅列出请求者能够 UNDROP（取消删除）的表。 因此，元存储/目录/架构所有者有权列出其各自安全对象所有权范围内的所有已删除表。 具有表级所有权的用户只能查看他们在输入目录/架构中拥有的表，前提是他们拥有父目录的 USE CATALOG 权限和父架构的 USE SCHEMA 权限。
语法
SHOW TABLES DROPPED [ { FROM | IN } schema_name ] [ LIMIT maxResults ]参数
schema_name
指定要从中列出表的架构名称。 如果未提供，则使用当前架构。 如果架构或目录不存在或已被删除，则会引发 SCHEMA_NOT_FOUND 错误。
maxResult
一个用于限制返回的表数的整数文本。
示例
CREATE DATABASE rain_db1;
CREATE TABLE t1(a int);
CREATE TABLE t2(a string);
CREATE DATABASE rain_db2;
CREATE TABLE t3(b int);
CREATE TABLE t4(b string);
USE DATABASE rain_db2;
SHOW TABLES;
+--------+---------+---------+----+--------------------+--------+-----------+
|database|tableName|tableType|size| createdAt|isShared|description|
+--------+---------+---------+----+--------------------+--------+-----------+
|rain_db1| t1| table| 0|2024-10-22 11:21:...| false| |
+--------+---------+---------+----+--------------------+--------+-----------+
|rain_db1| t2| table| 0|2024-10-22 11:21:...| false| |
+--------+---------+---------+----+--------------------+--------+-----------+
USE DATABASE rain_db1;
DROP TABLE t1;
SHOW tables dropped;
+--------+---------+---------+----+--------------------+--------+-----------+
|database|tableName|tableType|size| createdAt|isShared|description|
+--------+---------+---------+----+--------------------+--------+-----------+
|rain_db1| t1| table| 0|2024-10-22 11:21:...| false| |
+--------+---------+---------+----+--------------------+--------+-----------+
SHOW tables dropped in rain_db2;
+--------+---------+---------+----+--------------------+--------+-----------+
|database|tableName|tableType|size| createdAt|isShared|description|
+--------+---------+---------+----+--------------------+--------+-----------+
+--------+---------+---------+----+--------------------+--------+-----------+
SHOW tables dropped like '*1';
+--------+---------+---------+----+--------------------+--------+-----------+
|database|tableName|tableType|size| createdAt|isShared|description|
+--------+---------+---------+----+--------------------+--------+-----------+
|rain_db1| t1| table| 0|2024-10-22 11:21:...| false| |
+--------+---------+---------+----+--------------------+--------+-----------+