SHOW TABLES DROPPED

Platí pro: Databricks SQL Databricks Runtime 12.2 LTS a vyšší

Důležité

Tato funkce je ve verzi Public Preview.

Tento příkaz zobrazí seznam všech tables, které byly vyřazeny v rámci schema v Unity Catalog, ale dají se přesto rozbalit. Konkrétně obsahuje seznam všech vyřazených tables během doby uchovávání (výchozí hodnota je 7 dnů). Pokud došlo k vyřazení schema nebo catalog, dojde k chybě. Pokud žádný schema není zadán, vrátí se tables z aktuálního schema.

Příkaz bude pouze listtables, který žadatel je schopen obnovit. V důsledku toho mají vlastníci metastoru/catalog/schema oprávnění k list všechny vyřazené tables v rámci příslušného zabezpečitelného vlastnictví. Uživatelé s vlastnictvím na úrovni table budou moci zobrazit pouze tables, které vlastní ve vstupním catalog/schema, pokud mají oprávnění USE CATALOG u nadřazené catalog a oprávnění USE SCHEMA u nadřazené schema.

Syntaxe

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

Parameters

• schema_name

  Určuje název schema, ze kterého mají být uvedeny tables. Pokud není zadaný, použije aktuální schema. Pokud schema nebo catalog neexistují nebo byly odstraněny, vyvolá se SCHEMA_NOT_FOUND chyba.

• maxResult

  Celočíselná literál omezující počet vrácených tables.

Návraty

Příkaz s vytvoří sestavu list pro tables s následujícími columns:

Name	Datový typ	Vynulovatelné	Popis"
catalogName	STRING	ne	Název catalog uvedeného table.
schemaName	STRING	ne	Název schema uvedeného table.
tableName	STRING	ne	Název vyřazeného table
tableId	STRING	ne	ID table, které lze použít k identifikaci a zrušení konkrétní verze vyřazené table.
tableType	STRING	ne	Typ vyřazeného table v Unity Catalog
deletedAt	STRING	ne	Čas, kdy bylo table upuštěno.
createdAt	STRING	ne	Čas, kdy byl table vytvořen.
updatedAt	STRING	ne	Naposledy aktualizovaný čas pro table.
createdBy	STRING	ne	Subjekt, který vytvořil table.
vlastník	STRING	ne	Hlavní subjekt, který vlastní table.
komentář	STRING	ano	Volitelný table komentář.

Příklady

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

Související články

• SHOW TABLES
• UNDROP