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_name

  一覧表示するテーブルから、スキーマ名を指定します。 指定されていない場合は、現在のスキーマを使用します。 スキーマまたはカタログが存在しないか、削除されている場合は、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
  ----------- ---------- ---------- ------- --------- ----------------------------- ----------------------------- ----------------------------- ------------- ------------ -------

関連記事

• SHOW TABLES
• UNDROP