適用於：
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 | 字串 | 否 | 列出表格的目錄名稱。 |
| schemaName | 字串 | 否 | 列出的資料表的結構名稱。 |
| tableName | 字串 | 否 | 被刪除的資料表名稱 |
| tableId | 字串 | 否 | 可用來辨識並恢復特定版本已刪除資料表的資料表 ID。 |
| tableType | 字串 | 否 | Unity Catalog 中已刪除資料表的類型 |
| deletedAt | 字串 | 否 | 桌子被放下的時候。 |
| createdAt | 字串 | 否 | 該資料表的創建時間。 |
| updatedAt | 字串 | 否 | 表格最後更新的時間。 |
| createdBy | 字串 | 否 | 創建此表格的校長。 |
| 擁有者 | 字串 | 否 | 那位擁有這張桌子的校長。 |
| 留言 | 字串 | 是 | 關於可選表格的評論。 |
範例
-- 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 recovery period.
> USE CATALOG default;
> USE SCHEMA my_schema;
> CREATE TABLE my_table_1;
> DROP TABLE my_table_1;
-- Wait until the recovery period expires (7 days by default)
> SHOW TABLES DROPPED;
catalogname schemaname tablename tableid tabletype deletedat createdat updatedat createdby owner comment
----------- ---------- ---------- ------- --------- ----------------------------- ----------------------------- ----------------------------- ------------- ------------ -------