次の方法で共有


SHOW TABLES DROPPED

適用対象: check marked yes 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
  ----------- ---------- ---------- ------- --------- ----------------------------- ----------------------------- ----------------------------- ------------- ------------ -------