顯示已卸除的數據表

適用於： Databricks SQL Databricks Runtime 12.2 LTS 和更新版本

重要

這項功能處於公開預覽狀態。

此命令會列出已在 Unity 目錄架構內卸除的所有資料表，但仍可以取消復原。 具體來說，它會列出保留期間內所有卸除的數據表（預設值為 7 天）。 如果已卸除架構或目錄，就會引發錯誤。 如果未指定任何架構，則會從目前的架構傳回數據表。

此命令只會列出要求者能夠 UNDROP 的數據表。 因此，中繼存放區/目錄/架構擁有者具有許可權，可列出其各自安全性實體擁有權內的所有已卸除數據表。 具有數據表層級擁有權的使用者只能檢視在輸入目錄/架構內擁有的數據表，只要他們具有 USE CATALOG 父目錄的許可權和 USE SCHEMA 父架構的許可權。

語法

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

參數

• schema_name

  指定要列出資料表的架構名稱。 如果未提供，請使用目前的架構。 如果架構或目錄不存在或已卸除， 就會引發SCHEMA_NOT_FOUND 錯誤。

• maxResult

  整數常值，限制傳回的數據表數目。

傳回

命令會產生具有下列資料列之資料表清單的報表：

名稱	資料類型	Nullable	描述」
catalogName	字串	否	列出的數據表目錄名稱。
schemaName	字串	否	所列數據表的架構名稱。
tableName	字串	否	卸除數據表的名稱
tableId	字串	否	可用來識別和取消卸除特定版本的已卸除數據表的數據表標識碼。
tableType	字串	否	Unity 目錄中已卸除數據表的類型
deletedAt	字串	否	卸除數據表的時間。
createdAt	字串	否	建立數據表的時間。
updatedAt	字串	否	上次更新數據表的時間。
createdBy	字串	否	建立數據表的主體。
擁有者	字串	否	擁有數據表的主體。
comment	字串	是	選擇性數據表批注。

範例

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

相關文章

• 顯示數據表
• UNDROP