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