ZOBRAZENÍ VYŘAZENÝCH TABULEK

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 katalogu Unity vynechány, ale přesto je možné je rozbalit. 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 vrátit zpět. V důsledku toho mají vlastníci metastoru, katalogu nebo schématu oprávnění k výpisu všech vynechaných tabulek v příslušném zabezpečitelném vlastnictví. Uživatelé s vlastnictvím na úrovni tabulky budou moci zobrazit pouze tabulky, které vlastní v rámci vstupního katalogu nebo schématu, pokud mají USE CATALOG oprávnění pro nadřazený katalog a USE SCHEMA oprávnění 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, dojde k chybě SCHEMA_NOT_FOUND .

• maxResult

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

Návraty

Příkaz 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 vyřazené tabulky
tableId	STRING	ne	ID tabulky, které lze použít k identifikaci a vrácení konkrétní verze vyřazené tabulky.
tableType	STRING	ne	Typ vyřazené tabulky v katalogu Unity
deletedAt	STRING	ne	Čas, kdy byla tabulka ukončena.
createdAt	STRING	ne	Čas vytvoření tabulky
updatedAt	STRING	ne	Čas poslední aktualizace tabulky
createdBy	STRING	ne	Objekt zabezpečení, který vytvořil tabulku.
vlastník	STRING	ne	Objekt zabezpečení, 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