Dela via

SHOW TABLES DROPPED

  • Artikel

Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime 12.2 LTS och senare

Viktigt!

Den här funktionen finns som allmänt tillgänglig förhandsversion.

Det här kommandot visar alla tabeller som har raderats i schemat i Unity Catalog, men som fortfarande kan återställas. Mer specifikt visas alla borttagna tabeller inom kvarhållningsperioden (standardvärdet är 7 dagar). Om schemat eller katalogen har tagits bort utlöses ett fel. Om inget schema anges returneras tabellerna från det aktuella schemat.

Kommandot visar endast tabeller som förfrågaren kan UNDROP. Därför har metaarkiv-/katalog-/schemaägare behörighet att lista alla borttagna tabeller inom deras respektive skyddsbara ägarskap. Användare med ägarskap på tabellnivå kan bara visa tabeller som de äger i indatakatalogen/schemat så länge de har USE CATALOG behörighet i den överordnade katalogen och USE SCHEMA behörighet för det överordnade schemat.

Syntax

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

Parametrar

  • schema_name

    Anger schemanamnet som tabellerna ska visas från. Om det inte anges använder du det aktuella schemat. Om schemat eller katalogen inte finns eller har tagits bort utlöses ett SCHEMA_NOT_FOUND fel.

  • maxResult

    En heltalsliteral som begränsar antalet returnerade tabeller.

Returer

Kommandot s genererar en rapport över listan över tabeller med följande kolumner:

Name Datatyp Kan ha värdet null Beskrivning"
catalogName STRÄNG nej Katalognamnet för den angivna tabellen.
schemaName STRÄNG nej Schemanamnet för den angivna tabellen.
tableName STRÄNG nej Namnet på den borttagna tabellen
tableId STRÄNG nej Tabell-ID:t som kan användas för att identifiera och återställa en specifik version av den borttagna tabellen.
tableType STRÄNG nej Typen av borttagen tabell i Unity Catalog
deletedAt STRÄNG nej Tiden då tabellen togs bort.
createdAt STRÄNG nej Tiden då tabellen skapades.
updatedAt STRÄNG nej Den tid då tabellen senast uppdaterades.
createdBy STRÄNG nej Rektorn som skapade tabellen.
ägare STRÄNG nej Rektorn som äger bordet.
kommentar STRÄNG ja Den eventuella tabellkommentaren.

Exempel

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