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 tabulek, které byly v rámci schématu v Unity Catalogu odstraněny, ale přesto je možné je obnovit. Konkrétně obsahuje seznam všech vyřazených tabulek během doby uchovávání (výchozí hodnota je 7 dnů). Pokud došlo k vyřazení schématu nebo katalogu, vyvolá se chyba. Pokud není zadáno žádné schéma, vrátí se tabulky z aktuálního schématu.

Příkaz zobrazí pouze tabulky, které žadatel může undrop. V důsledku toho mají vlastníci metastoru, katalogu nebo schématu oprávnění k výpisu všech odstraněných tabulek ve svých příslušných zabezpečených vlastnictvích. Uživatelé s vlastnictvím na úrovni tabulky budou moct zobrazit pouze tabulky, které vlastní v rámci vstupního katalogu nebo schématu, pokud mají oprávnění USE CATALOG nadřazeného katalogu a oprávnění USE SCHEMA nadřazeného schématu.

Syntaxe

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

Parametry

• schema_name

  Určuje název schématu, ze kterého mají být uvedeny tabulky. Pokud není k dispozici, použije aktuální schéma. Pokud schéma nebo katalog neexistuje nebo byl ukončen, vyvolá se SCHEMA_NOT_FOUND chyba.

• maxResult

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

Návraty

Příkaz s vytvoří sestavu seznamu tabulek s následujícími sloupci:

Name	Datový typ	Vynulovatelné	Popis"
catalogName	STRING	ne	Název katalogu uvedené tabulky.
schemaName	STRING	ne	Název schématu uvedené tabulky.
tableName	STRING	ne	Název odstraněné tabulky
tableId	STRING	ne	Identifikátor tabulky, který lze použít k identifikaci a obnovení konkrétní verze smazané tabulky.
tableType	STRING	ne	Typ odstraněné tabulky v katalogu Unity
deletedAt	STRING	ne	Čas, kdy byl stůl upuštěn.
createdAt	STRING	ne	Čas vytvoření tabulky
updatedAt	STRING	ne	Čas poslední aktualizace tabulky
createdBy	STRING	ne	Ředitel, který vytvořil tabulku.
vlastník	STRING	ne	Principál, který vlastní tabulku.
komentář	STRING	ano	Volitelný komentář k tabulce.

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