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 tables som har tagits bort inom schema i Unity Catalog, men som fortfarande kan återställas. Mer specifikt visas alla borttagna tables inom kvarhållningsperioden (standardvärdet är 7 dagar). Om schema eller catalog har tagits bort utlöses ett fel. Om ingen schema anges returneras tables från den aktuella schema.

Kommandot kommer endast att listtables som beställaren kan UNDROP-. Därför har metadatastore/catalog/schema-ägare rättigheter att list alla borttagna tables inom respektive säkerställt ägande. Användare med ägarskap av table-nivå kommer endast kunna se tables som de äger i catalog/schema-inmatningen så länge de har USE CATALOG-behörighet på den överordnade catalog och USE SCHEMA-behörighet på den överordnade schema.

Syntax

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

Parameters

  • schema_name

    Anger namnet för schema som tables ska listas från. Om det inte anges, används den aktuella schema. Om schema eller catalog inte finns eller har tagits bort uppstår ett SCHEMA_NOT_FOUND fel.

  • maxResult

    En heltalsliteral som begränsar antalet returnerade tables.

Returer

Kommandot s genererar en rapport över list för tables med följande columns:

Name Datatyp Kan ha värdet null Beskrivning"
catalogName STRÄNG nej catalog-namnet på den listade table.
schemaName STRÄNG nej Det angivna table-namnet på schema.
tableName STRÄNG nej Namnet på den borttagna table
tableId STRÄNG nej Det table-ID som kan användas för att identifiera och återställa en specifik version av den borttagna table.
tableType STRÄNG nej Typen av borttagen table i Unity Catalog
deletedAt STRÄNG nej Tiden då table släpptes.
createdAt STRÄNG nej Tiden då table skapades.
updatedAt STRÄNG nej Tiden då table senast uppdaterades.
createdBy STRÄNG nej Huvudmannen som skapade table.
ägare STRÄNG nej Rektorn som har ägarskap över table.
kommentar STRÄNG ja Valfri table-kommentar.

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